Docs
Servidor MCPHerramientas disponibles

Leer productos

Busca productos, consulta un producto, sus proveedores vinculados o las clasificaciones requeridas para guardar productos.

Herramienta MCPget_products

Propósito

Busca productos, consulta un producto, sus proveedores vinculados o las clasificaciones requeridas para guardar productos.

Usar cuando
Necesitas un identificador, datos del catálogo o valores de clasificación de productos.
No usar cuando
Necesitas el catálogo oficial de claves del SAT.
Permisos requeridos
products:read
Efectos secundarios
Ninguno
Idempotencia
Idempotente

Esquema de entrada

JSON Schema
{  "type": "object",  "properties": {    "input": {      "oneOf": [        {          "type": "object",          "properties": {            "operation": {              "type": "string",              "const": "search"            },            "query": {              "type": "string",              "minLength": 1            },            "status": {              "default": "active",              "type": "string",              "enum": [                "active",                "inactive",                "all"              ]            },            "stockStatus": {              "type": "string",              "enum": [                "available",                "out_of_stock"              ]            },            "cursor": {              "type": "string"            },            "limit": {              "type": "integer",              "minimum": 1,              "maximum": 100            }          },          "required": [            "operation",            "status"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "operation": {              "type": "string",              "const": "get"            },            "productId": {              "type": "string"            }          },          "required": [            "operation",            "productId"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "operation": {              "type": "string",              "const": "suppliers"            },            "productId": {              "type": "string"            }          },          "required": [            "operation",            "productId"          ],          "additionalProperties": false        }      ]    }  },  "required": [    "input"  ],  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false}

Esquema de salida

JSON Schema
{  "type": "object",  "properties": {    "data": {      "anyOf": [        {          "type": "object",          "properties": {            "products": {              "type": "array",              "items": {                "$ref": "#/definitions/__schema0"              }            },            "nextCursor": {              "anyOf": [                {                  "type": "string"                },                {                  "type": "null"                }              ]            },            "hasMore": {              "type": "boolean"            }          },          "required": [            "products",            "nextCursor",            "hasMore"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "suppliers": {              "type": "array",              "items": {                "type": "object",                "properties": {                  "supplierId": {                    "type": "string"                  },                  "legalName": {                    "type": "string"                  },                  "rfc": {                    "type": "string"                  },                  "email": {                    "type": "string"                  }                },                "required": [                  "supplierId",                  "legalName"                ],                "additionalProperties": false              }            }          },          "required": [            "suppliers"          ],          "additionalProperties": false        },        {          "$ref": "#/definitions/__schema0"        }      ]    },    "error": {      "$schema": "http://json-schema.org/draft-07/schema#",      "type": "object",      "properties": {        "code": {          "type": "string",          "enum": [            "validation_error",            "unauthenticated",            "forbidden",            "not_found",            "method_not_allowed",            "conflict",            "idempotency_conflict",            "operation_in_progress",            "recovery_required",            "rate_limited",            "provider_unavailable",            "internal"          ]        },        "message": {          "type": "string"        },        "details": {          "type": "object",          "properties": {            "issues": {              "type": "array",              "items": {                "type": "object",                "properties": {                  "path": {                    "type": "array",                    "items": {                      "anyOf": [                        {                          "type": "string"                        },                        {                          "type": "number"                        }                      ]                    }                  },                  "message": {                    "type": "string"                  },                  "code": {                    "type": "string"                  }                },                "required": [                  "path",                  "message"                ],                "additionalProperties": false              }            },            "retryable": {              "type": "boolean"            },            "retryAfterSeconds": {              "type": "integer",              "exclusiveMinimum": 0,              "maximum": 9007199254740991            }          },          "additionalProperties": false        }      },      "required": [        "code",        "message"      ],      "additionalProperties": false    }  },  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false,  "definitions": {    "__schema0": {      "type": "object",      "properties": {        "productId": {          "type": "string",          "minLength": 1        },        "description": {          "type": "string"        },        "sku": {          "type": "string"        },        "code": {          "type": "string"        },        "active": {          "type": "boolean"        },        "price": {          "type": "number"        },        "quantityDiscounts": {          "maxItems": 10,          "type": "array",          "items": {            "$ref": "#/definitions/__schema1"          }        },        "taxIncluded": {          "type": "boolean"        },        "taxRate": {          "type": "number"        },        "taxability": {          "type": "string"        },        "taxExemptReason": {          "type": "string"        },        "stock": {          "type": "number"        },        "stockStatus": {          "type": "string",          "enum": [            "available",            "out_of_stock"          ]        },        "satProductCode": {          "type": "string"        },        "satUnitCode": {          "type": "string"        },        "updatedAt": {          "type": "string",          "format": "date-time"        }      },      "required": [        "productId",        "description",        "active",        "price",        "updatedAt"      ],      "additionalProperties": false    },    "__schema1": {      "type": "object",      "properties": {        "minQuantity": {          "type": "number"        },        "percentage": {          "type": "number"        }      },      "required": [        "minQuantity",        "percentage"      ],      "additionalProperties": false    }  },  "oneOf": [    {      "required": [        "data"      ]    },    {      "required": [        "error"      ]    }  ]}

Flujo relacionado

Consulta los flujos canónicos en la introducción

Herramientas relacionadas