{ "item": [ { "name": "Inventario externo", "description": { "content": "Tu sistema es la fuente de verdad de la existencia.", "type": "text/plain" }, "item": [ { "name": "Verificar la llave", "request": { "name": "Verificar la llave", "description": { "content": "Confirma que la llave es válida y devuelve el negocio, sus scopes y el estado de la integración. Límite: 30 por minuto.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "external", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "originalRequest": { "url": { "path": [ "api", "v1", "external", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": true,\n \"tenant_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\",\n \"key_prefix\": \"pdk_live_ab12cd34\",\n \"scopes\": [\n \"stock:write\",\n \"catalog:read\"\n ],\n \"integration\": {\n \"direction\": \"inbound\",\n \"enabled\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INVALID_API_KEY` o `API_KEY_REVOKED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`MODULE_DISABLED`, `INSUFFICIENT_SCOPE` o `INTEGRATION_DISABLED` (escrituras).", "originalRequest": { "url": { "path": [ "api", "v1", "external", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`RATE_LIMITED`. Espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Segundos que hay que esperar antes de reintentar.", "key": "Retry-After", "value": "42" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INTERNAL_ERROR`. Reintenta con espera; cita el `request_id` a soporte.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "Enviar existencias", "request": { "name": "Enviar existencias", "description": { "content": "Fija la existencia **absoluta** de hasta 500 productos en una transacción. Un ítem malo no tumba el lote: cada ítem trae su `status`. A lo que envías se le restan las ventas de papedir que tu sistema todavía no confirmó (`reserved`). Límite: 60 por minuto.\n\nScope requerido: `stock:write`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "originalRequest": { "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"index\": 0,\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"sku\": \"string\",\n \"menu_item_id\": 43,\n \"status\": \"applied\",\n \"stock_after\": 12,\n \"reserved\": 0\n },\n {\n \"index\": 0,\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"sku\": \"string\",\n \"menu_item_id\": 43,\n \"status\": \"applied\",\n \"stock_after\": 12,\n \"reserved\": 0\n }\n ],\n \"summary\": {\n \"applied\": 2,\n \"duplicate\": 0,\n \"stale\": 0,\n \"not_found\": 0,\n \"untracked\": 0,\n \"invalid\": 0\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`VALIDATION_FAILED` (con `details`), `IDEMPOTENCY_KEY_REQUIRED` o `EXTERNAL_STOCK_TOO_MANY_ITEMS`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INVALID_API_KEY` o `API_KEY_REVOKED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`MODULE_DISABLED`, `INSUFFICIENT_SCOPE` o `INTEGRATION_DISABLED` (escrituras).", "originalRequest": { "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`RATE_LIMITED`. Espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Segundos que hay que esperar antes de reintentar.", "key": "Retry-After", "value": "42" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INTERNAL_ERROR`. Reintenta con espera; cita el `request_id` a soporte.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "stock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Única por lote (8 a 100 caracteres: letras, números, `. _ : -`). Repítela en los reintentos del mismo lote.", "key": "Idempotency-Key", "value": "lote-2026-10-08T15-00-00Z" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"stock\": 12,\n \"sku\": \"PAN-02\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"version\": 1728399600000,\n \"observed_at\": \"2026-10-08T15:00:00Z\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "Leer el catálogo", "request": { "name": "Leer el catálogo", "description": { "content": "Productos vivos del negocio en orden de `id`, por páginas. `tracked: false` = papedir no lleva inventario de ese producto. Límite: 60 por minuto.\n\nScope requerido: `catalog:read`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "cursor", "value": "0", "description": "`next_cursor` de la página anterior (0 o vacío = desde el principio)." }, { "disabled": false, "key": "limit", "value": "100", "description": "Tamaño de página (100 por defecto)." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "cursor", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": 43,\n \"sku\": \"PAN-01\",\n \"external_id\": \"string\",\n \"name\": \"Pan de yuca\",\n \"unit\": \"unidad\",\n \"stock\": 12,\n \"tracked\": true,\n \"available\": true,\n \"updated_at\": \"2026-10-08T15:00:00.000Z\"\n },\n {\n \"id\": 43,\n \"sku\": \"PAN-01\",\n \"external_id\": \"string\",\n \"name\": \"Pan de yuca\",\n \"unit\": \"unidad\",\n \"stock\": 12,\n \"tracked\": true,\n \"available\": true,\n \"updated_at\": \"2026-10-08T15:00:00.000Z\"\n }\n ],\n \"next_cursor\": 43\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`VALIDATION_FAILED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "cursor", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INVALID_API_KEY` o `API_KEY_REVOKED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "cursor", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`MODULE_DISABLED`, `INSUFFICIENT_SCOPE` o `INTEGRATION_DISABLED` (escrituras).", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "cursor", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`RATE_LIMITED`. Espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "cursor", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Segundos que hay que esperar antes de reintentar.", "key": "Retry-After", "value": "42" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INTERNAL_ERROR`. Reintenta con espera; cita el `request_id` a soporte.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "cursor", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "Cruzar productos por SKU", "request": { "name": "Cruzar productos por SKU", "description": { "content": "Asigna a cada producto de papedir (buscado por SKU) el id que tiene en tu sistema; `null` quita el cruce. Resultado por producto. Límite: 30 por minuto.\n\nScope requerido: `stock:write`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"index\": 0,\n \"sku\": \"PAN-01\",\n \"status\": \"mapped\",\n \"menu_item_id\": 43\n },\n {\n \"index\": 0,\n \"sku\": \"PAN-01\",\n \"status\": \"mapped\",\n \"menu_item_id\": 43\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`VALIDATION_FAILED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INVALID_API_KEY` o `API_KEY_REVOKED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`MODULE_DISABLED`, `INSUFFICIENT_SCOPE` o `INTEGRATION_DISABLED` (escrituras).", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`EXTERNAL_ID_TAKEN`: otro cruce simultáneo tomó el mismo id; reintenta.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`RATE_LIMITED`. Espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Segundos que hay que esperar antes de reintentar.", "key": "Retry-After", "value": "42" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INTERNAL_ERROR`. Reintenta con espera; cita el `request_id` a soporte.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "catalog", "mapping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "Leer eventos de pedido", "request": { "name": "Leer eventos de pedido", "description": { "content": "Feed de eventos de pedido en orden (respaldo del webhook, o vía principal si no hay webhook). Los ya confirmados siguen apareciendo: guarda tu cursor y deduplica por `id`. Límite: 60 por minuto.\n\nScope requerido: `orders:read`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "after", "value": "0", "description": "`next_cursor` de la página anterior (0 = desde el principio)." }, { "disabled": false, "key": "limit", "value": "100", "description": "Tamaño de página (100 por defecto)." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "after", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"events\": [\n {\n \"cursor\": 1042,\n \"id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\",\n \"type\": \"order.created\",\n \"created_at\": \"2026-10-08T15:00:00.000Z\",\n \"data\": {\n \"order_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\",\n \"order_num\": 128,\n \"status\": \"pending\",\n \"payment_status\": \"pending\",\n \"payment_type\": \"cash\",\n \"is_paid\": false,\n \"order_type\": \"takeout\",\n \"total\": 6500,\n \"currency\": \"COP\",\n \"created_at\": \"2026-10-08T15:00:00.000Z\",\n \"items\": [\n {\n \"menu_item_id\": 43,\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"name\": \"Pan de yuca\",\n \"quantity\": 2,\n \"unit_price\": 2000,\n \"line_total\": 4000\n },\n {\n \"menu_item_id\": 43,\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"name\": \"Pan de yuca\",\n \"quantity\": 2,\n \"unit_price\": 2000,\n \"line_total\": 4000\n }\n ]\n },\n \"delivered\": false\n },\n {\n \"cursor\": 1042,\n \"id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\",\n \"type\": \"order.created\",\n \"created_at\": \"2026-10-08T15:00:00.000Z\",\n \"data\": {\n \"order_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\",\n \"order_num\": 128,\n \"status\": \"pending\",\n \"payment_status\": \"pending\",\n \"payment_type\": \"cash\",\n \"is_paid\": false,\n \"order_type\": \"takeout\",\n \"total\": 6500,\n \"currency\": \"COP\",\n \"created_at\": \"2026-10-08T15:00:00.000Z\",\n \"items\": [\n {\n \"menu_item_id\": 43,\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"name\": \"Pan de yuca\",\n \"quantity\": 2,\n \"unit_price\": 2000,\n \"line_total\": 4000\n },\n {\n \"menu_item_id\": 43,\n \"sku\": \"PAN-01\",\n \"external_id\": \"b3f1c2d4-0000-4000-8000-000000000001\",\n \"name\": \"Pan de yuca\",\n \"quantity\": 2,\n \"unit_price\": 2000,\n \"line_total\": 4000\n }\n ]\n },\n \"delivered\": false\n }\n ],\n \"next_cursor\": 1042\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`VALIDATION_FAILED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "after", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INVALID_API_KEY` o `API_KEY_REVOKED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "after", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`MODULE_DISABLED`, `INSUFFICIENT_SCOPE` o `INTEGRATION_DISABLED` (escrituras).", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "after", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`RATE_LIMITED`. Espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "after", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Segundos que hay que esperar antes de reintentar.", "key": "Retry-After", "value": "42" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INTERNAL_ERROR`. Reintenta con espera; cita el `request_id` a soporte.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "after", "value": "0" }, { "key": "limit", "value": "100" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "Confirmar eventos", "request": { "name": "Confirmar eventos", "description": { "content": "Marca como confirmados los eventos que procesaste por el feed: el webhook ya no los manda y dejan de reservar existencia. Límite: 60 por minuto.\n\nScope requerido: `orders:read`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"acknowledged\": 2\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`VALIDATION_FAILED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INVALID_API_KEY` o `API_KEY_REVOKED`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`MODULE_DISABLED`, `INSUFFICIENT_SCOPE` o `INTEGRATION_DISABLED` (escrituras).", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`RATE_LIMITED`. Espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": "Segundos que hay que esperar antes de reintentar.", "key": "Retry-After", "value": "42" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "name": "`INTERNAL_ERROR`. Reintenta con espera; cita el `request_id` a soporte.", "originalRequest": { "url": { "path": [ "api", "v1", "external", "orders", "ack" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"event_ids\": [\n \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"VALIDATION_FAILED\",\n \"message\": \"La petición no cumple el formato.\",\n \"details\": [\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n },\n {\n \"field\": \"items.0.stock\",\n \"issue\": \"must not be less than 0\"\n }\n ]\n },\n \"request_id\": \"5b1f0c1e-7c1a-4a8e-9d51-2d8d3f0a9c11\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "name": "Webhooks", "description": { "content": "Eventos que papedir envía a la URL del negocio.", "type": "text/plain" }, "item": [], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.pedidos.transformit.com.co", "key": "baseUrl" } ], "info": { "name": "API pública de papedir", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "API para conectar sistemas de terceros con un negocio de papedir.\n\n- Autenticación: `Authorization: Bearer pdk_live_…` (una llave por sistema, con scopes).\n- Errores: siempre `{ \"error\": { \"code\", \"message\", \"details\"? }, \"request_id\" }` y cabecera `X-Request-Id`.\n- Versiones: `/api/v1` es estable; solo se agregan campos, rutas y eventos (ignora lo que no conozcas). Un cambio que rompe es `/api/v2`, con 6 meses de aviso (`Deprecation`/`Sunset`).\n\nGuías y ejemplos: https://docs.papedir.com\n\nContact Support:\n Name: papedir\n Email: soporte@papedir.com", "type": "text/plain" } } }