Docs
Servidor MCPHerramientas disponibles

Recibir inventario

Registra una entrega de inventario de proveedor con varios productos.

Herramienta MCPreceive_inventory

Propósito

Registra una entrega de inventario de proveedor con varios productos.

Usar cuando
Se recibió una entrega de un proveedor.
No usar cuando
Solo corriges la existencia de un producto.
Permisos requeridos
products:manage
Efectos secundarios
Destructivo
Idempotencia
Idempotente

Esquema de entrada

JSON Schema
{  "type": "object",  "properties": {    "idempotencyKey": {      "type": "string",      "minLength": 1,      "maxLength": 200,      "description": "Unique retry key for this exact operation. Reuse it only when retrying the same request."    },    "input": {      "type": "object",      "properties": {        "supplierId": {          "$ref": "#/definitions/__schema0"        },        "locationId": {          "$ref": "#/definitions/__schema1"        },        "reference": {          "$ref": "#/definitions/__schema2"        },        "note": {          "$ref": "#/definitions/__schema3"        },        "items": {          "$ref": "#/definitions/__schema4"        }      },      "required": [        "supplierId",        "locationId",        "items"      ],      "additionalProperties": false    }  },  "required": [    "idempotencyKey",    "input"  ],  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false,  "definitions": {    "__schema0": {      "type": "string",      "minLength": 1    },    "__schema1": {      "type": "string",      "minLength": 1    },    "__schema2": {      "type": "string",      "minLength": 1,      "maxLength": 120    },    "__schema3": {      "type": "string",      "minLength": 1,      "maxLength": 500    },    "__schema4": {      "minItems": 1,      "maxItems": 50,      "type": "array",      "items": {        "$ref": "#/definitions/__schema5"      }    },    "__schema5": {      "type": "object",      "properties": {        "productId": {          "type": "string",          "minLength": 1        },        "quantity": {          "type": "number",          "exclusiveMinimum": 0        }      },      "required": [        "productId",        "quantity"      ],      "additionalProperties": false    }  }}

Esquema de salida

JSON Schema
{  "type": "object",  "properties": {    "data": {      "type": "object",      "properties": {        "inventoryReceiptId": {          "type": "string"        },        "itemCount": {          "type": "integer",          "exclusiveMinimum": 0,          "maximum": 9007199254740991        }      },      "required": [        "inventoryReceiptId",        "itemCount"      ],      "additionalProperties": false    },    "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,  "oneOf": [    {      "required": [        "data"      ]    },    {      "required": [        "error"      ]    }  ]}

Flujo relacionado

Consulta los flujos canónicos en la introducción

Herramientas relacionadas