{ "item": [ { "name": "Facturas", "description": "Facturas electrónicas de venta. Se numeran con el rango activo del emisor.", "item": [ { "id": "6bf2fda9-8e3e-442c-81c5-e94716d48a1c", "name": "Crear una factura", "request": { "name": "Crear una factura", "description": { "content": "Valida la factura, le asigna el siguiente número del rango activo del emisor y la encola. Responde 202 con estado `RECEIVED`; Cetus la firma, la envía a la DIAN y la entrega al cliente en segundo plano. Consulta el resultado con `GET /v1/invoices/{id}` o con el webhook `invoice.accepted`.", "type": "text/plain" }, "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "3fcc7e3f-ce1b-481c-a3f6-551110ce04c2", "name": "Factura recibida y encolada. Repetir la petición con la misma `Idempotency-Key` devuelve esta misma respuesta.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"id\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"0199f6a2-5b1c-7c3e-9a51-2f8d4c6e7a10\",\n \"number\": \"SIM1\",\n \"status\": \"RECEIVED\",\n \"cufe\": null,\n \"issueDate\": \"2026-10-25\",\n \"currency\": \"COP\",\n \"totals\": {\n \"lineExtension\": 100000,\n \"taxExclusive\": 100000,\n \"taxInclusive\": 119000,\n \"payable\": 119000\n },\n \"dian\": {\n \"statusCode\": null,\n \"statusMessage\": null,\n \"errors\": [],\n \"validatedAt\": null\n },\n \"externalReference\": null,\n \"createdAt\": \"2026-10-25T15:15:30.123Z\",\n \"creditNotes\": [],\n \"debitNotes\": [],\n \"balance\": 119000,\n \"deliveries\": []\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80ba69fa-09ca-493e-9c20-2a9f29248d08", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16ebb66b-d31a-466f-b6ae-0d6b196c49c8", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1cf25e46-435e-4e29-a491-283413d30edb", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a35e155a-2448-4d08-98a7-c6fb0c9b6b57", "name": "`idempotency_in_progress`: otra petición con la misma `Idempotency-Key` todavía se está\nprocesando. Reintenta en unos segundos.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66ea34df-fa40-4853-830f-85f85df308fd", "name": "La factura no se puede emitir:\n\n- `idempotency_mismatch`: la `Idempotency-Key` ya se usó con un cuerpo distinto.\n- `issuer_not_found`, `issuer_required`: no hay emisor que pueda emitir, o hay varios y falta `issuerId`.\n- `issuer_not_ready`, `issuer_missing_software`, `issuer_missing_certificate`: el emisor no está\n habilitado o le falta configuración.\n- `no_active_numbering_range`: el emisor no tiene un rango de numeración vigente.\n- `customer_identification_invalid`, `customer_check_digit_invalid`: la identificación del\n adquiriente no tiene el formato de su tipo o el dígito de verificación no corresponde.\n- `payment_due_date_required`: un pago a crédito necesita `dueDate`.\n- `lines_required`, `line_description_required`, `line_quantity_invalid`, `line_price_invalid`,\n `line_tax_invalid`, `amount_too_large`: alguna línea o el total no es válido.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Unprocessable Entity\",\n \"status\": 422,\n \"detail\": \"The account has several issuers in the SANDBOX environment; send issuerId\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"issuer_required\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f6a0d3a-4b83-466b-b34e-64015ced00a3", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan.\n`sandbox_daily_limit`: la cuenta ya emitió los documentos de simulación del día; el límite se\nreinicia a medianoche, hora de Colombia. En ambos casos, espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customer\": {\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \"1020304050\",\n \"legalName\": \"Consumidor Final\"\n },\n \"payment\": {\n \"method\": \"CASH\",\n \"meansCode\": \"10\"\n },\n \"lines\": [\n {\n \"itemCode\": \"SERV-1\",\n \"description\": \"Servicio de consultoría\",\n \"quantity\": 1,\n \"unitPrice\": 100000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 202) {", " pm.collectionVariables.set(\"invoiceId\", pm.response.json().id);", "}" ] } } ], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4714fa1f-5b57-4361-bd43-3ed95a9bdd39", "name": "Consultar una factura", "request": { "name": "Consultar una factura", "description": { "content": "La factura con su estado ante la DIAN, las notas crédito y débito emitidas sobre ella, el saldo que les queda y sus entregas al cliente.", "type": "text/plain" }, "url": { "path": [ "v1", "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{invoiceId}}", "key": "id", "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "064ae148-157c-4cc8-8a57-695f427c9c6e", "name": "La factura.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"0199f6a2-5b1c-7c3e-9a51-2f8d4c6e7a10\",\n \"number\": \"SIM1\",\n \"status\": \"ACCEPTED\",\n \"cufe\": \"3f1a9c0e8b7d6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d\",\n \"issueDate\": \"2026-10-25\",\n \"currency\": \"COP\",\n \"totals\": {\n \"lineExtension\": 100000,\n \"taxExclusive\": 100000,\n \"taxInclusive\": 119000,\n \"payable\": 119000\n },\n \"dian\": {\n \"statusCode\": \"00\",\n \"statusMessage\": \"Procesado Correctamente.\",\n \"errors\": [],\n \"validatedAt\": \"2026-10-25T15:15:32.481Z\"\n },\n \"externalReference\": null,\n \"createdAt\": \"2026-10-25T15:15:30.123Z\",\n \"creditNotes\": [],\n \"debitNotes\": [],\n \"balance\": 119000,\n \"deliveries\": [\n {\n \"id\": \"0199f6b0-1c4d-7e52-9b6a-0f1e2d3c4b5a\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"cliente@example.com\",\n \"status\": \"DELIVERED\",\n \"error\": null,\n \"sentAt\": \"2026-10-25T15:15:33.010Z\",\n \"lastEventAt\": \"2026-10-25T15:15:35.200Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d99ec19-2289-4499-a5c5-7f7bf26cb0ba", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15c920bf-7fe8-4a5b-9a34-a9cd89c8cbdf", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be1a7113-f52c-4e45-85d3-e2329972bc37", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4af8613a-47f5-4f0b-9657-78685f7e7498", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "daee73b3-7d3e-4217-bc46-bc6f9a28778c", "name": "Descargar un archivo de la factura", "request": { "name": "Descargar un archivo de la factura", "description": { "content": "Una URL temporal para descargar el XML firmado, el PDF o el AttachedDocument de la factura.", "type": "text/plain" }, "url": { "path": [ "v1", "invoices", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{invoiceId}}", "key": "id", "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" } }, { "type": "any", "value": "pdf", "key": "file", "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8424c102-dd24-4955-8396-81d7494563f0", "name": "La URL de descarga.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"string\",\n \"expiresAt\": \"1966-09-24T11:50:02.748Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b96dfe3e-0134-4cf8-9d66-0ff6288a690e", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0643bce0-6507-4341-b672-d95e1279958f", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb789ebe-faf0-49f5-a62a-c324fe25e379", "name": "`not_found`: el documento no existe en el ambiente de la llave. `file_not_available`: el archivo\ntodavía no existe; el XML y el PDF aparecen cuando la DIAN acepta el documento.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c81e167-f594-46ac-8ea0-83eb92be932c", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "invoices", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Notas crédito", "description": "Anulan o disminuyen el valor de una factura aceptada por la DIAN.", "item": [ { "id": "6b1e3890-a1f3-4cb9-8e66-0b73fbff11d6", "name": "Crear una nota crédito", "request": { "name": "Crear una nota crédito", "description": { "content": "Emite una nota crédito sobre una factura aceptada por la DIAN, para anularla o disminuir su valor. El cliente, la moneda y el pago se toman de la factura. Responde 202 con estado `RECEIVED`; consulta el resultado con `GET /v1/credit-notes/{id}` o con el webhook `credit_note.accepted`.", "type": "text/plain" }, "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"{{invoiceId}}\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b9640a25-ba09-4acd-883b-c1b13a6651ed", "name": "Nota recibida y encolada. Repetir la petición con la misma `Idempotency-Key` devuelve esta misma respuesta.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"id\": \"7feF1FaA-3bff-CEB2-7eE6-b9d47cf84D00\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"37B6163e-dbFE-50Fa-B18c-99b7AC7A7dDb\",\n \"number\": \"string\",\n \"status\": \"RECEIVED\",\n \"cude\": \"string\",\n \"issueDate\": \"2005-01-07\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"AbDD1a3e-2ffD-87d0-0E15-EcCFd2bDaf2e\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"EARLY_PAYMENT_DISCOUNT\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 1227.8463515399997,\n \"taxExclusive\": 5521.307221759805,\n \"taxInclusive\": 9205.147465883396,\n \"payable\": 643.7272976549868\n },\n \"dian\": {\n \"statusCode\": \"string\",\n \"statusMessage\": null,\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1958-09-05T05:36:19.923Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"2020-11-13T03:07:17.222Z\",\n \"deliveries\": [\n {\n \"id\": \"9BDc5b2c-54bf-2B31-862f-DB44faDfc00D\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"FAILED\",\n \"error\": null,\n \"sentAt\": \"1998-09-30T22:25:56.024Z\",\n \"lastEventAt\": \"1948-08-17T06:55:42.054Z\"\n },\n {\n \"id\": \"30CccbCE-7C2F-a880-3eF8-F9DFff2beC2D\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"FAILED\",\n \"error\": \"string\",\n \"sentAt\": \"1952-12-01T08:27:59.310Z\",\n \"lastEventAt\": \"2025-07-06T10:45:01.663Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a7d5e0d-455a-42c7-8385-709887a0d69e", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0cf47f7-dc21-4f6b-8386-f62a489f47e6", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6de4e495-4dff-4f6f-9b50-31838f96cc27", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "526447ed-804b-49a7-8ede-ae2661617292", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "affc6746-8f89-468e-953f-7f6bf0b9350a", "name": "`idempotency_in_progress`: otra petición con la misma `Idempotency-Key` todavía se está\nprocesando. Reintenta en unos segundos.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "493ae9df-1cd1-4f9f-9ad0-152c1ea41a05", "name": "La nota no se puede emitir:\n\n- `idempotency_mismatch`: la `Idempotency-Key` ya se usó con un cuerpo distinto.\n- `invoice_not_accepted`: la factura todavía no está aceptada por la DIAN.\n- `credit_note_exceeds_balance`: la nota crédito supera el saldo que le queda a la factura.\n- `credit_note_lines_required`: solo una anulación (`CANCELLATION`) puede omitir las líneas.\n- `issuer_not_ready`, `issuer_missing_software`, `issuer_missing_certificate`,\n `no_active_numbering_range`: el emisor no puede emitir este tipo de documento.\n- `lines_required`, `line_description_required`, `line_quantity_invalid`, `line_price_invalid`,\n `line_tax_invalid`, `amount_too_large`: alguna línea o el total no es válido.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24b5a007-f2e1-4d37-9b6a-4abf32460b15", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan.\n`sandbox_daily_limit`: la cuenta ya emitió los documentos de simulación del día; el límite se\nreinicia a medianoche, hora de Colombia. En ambos casos, espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "credit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"CANCELLATION\",\n \"description\": \"Factura emitida por error\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 202) {", " pm.collectionVariables.set(\"creditNoteId\", pm.response.json().id);", "}" ] } } ], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8026a128-997e-4b79-b8e7-a78985d4e92e", "name": "Consultar una nota crédito", "request": { "name": "Consultar una nota crédito", "description": { "content": "La nota con su estado ante la DIAN, la factura que corrige y sus entregas al cliente.", "type": "text/plain" }, "url": { "path": [ "v1", "credit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{creditNoteId}}", "key": "id", "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "311ec013-b45a-49a3-a2fa-f069b9c17a03", "name": "La nota.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"7feF1FaA-3bff-CEB2-7eE6-b9d47cf84D00\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"37B6163e-dbFE-50Fa-B18c-99b7AC7A7dDb\",\n \"number\": \"string\",\n \"status\": \"RECEIVED\",\n \"cude\": \"string\",\n \"issueDate\": \"2005-01-07\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"AbDD1a3e-2ffD-87d0-0E15-EcCFd2bDaf2e\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"EARLY_PAYMENT_DISCOUNT\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 1227.8463515399997,\n \"taxExclusive\": 5521.307221759805,\n \"taxInclusive\": 9205.147465883396,\n \"payable\": 643.7272976549868\n },\n \"dian\": {\n \"statusCode\": \"string\",\n \"statusMessage\": null,\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1958-09-05T05:36:19.923Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"2020-11-13T03:07:17.222Z\",\n \"deliveries\": [\n {\n \"id\": \"9BDc5b2c-54bf-2B31-862f-DB44faDfc00D\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"FAILED\",\n \"error\": null,\n \"sentAt\": \"1998-09-30T22:25:56.024Z\",\n \"lastEventAt\": \"1948-08-17T06:55:42.054Z\"\n },\n {\n \"id\": \"30CccbCE-7C2F-a880-3eF8-F9DFff2beC2D\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"FAILED\",\n \"error\": \"string\",\n \"sentAt\": \"1952-12-01T08:27:59.310Z\",\n \"lastEventAt\": \"2025-07-06T10:45:01.663Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f14f91c-90f8-49cf-becb-641f7d47110c", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bacbee4-eedf-479e-b08f-901dd92233bd", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab9fb209-671b-40d7-83a9-4de02468fbfa", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e22ff32-b79b-406a-b996-ff59a3700176", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b089f8fe-4141-4ab8-b0db-a63f173142c5", "name": "Descargar un archivo de la nota crédito", "request": { "name": "Descargar un archivo de la nota crédito", "description": { "content": "Una URL temporal para descargar el XML firmado, el PDF o el AttachedDocument de la nota.", "type": "text/plain" }, "url": { "path": [ "v1", "credit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{creditNoteId}}", "key": "id", "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" } }, { "type": "any", "value": "pdf", "key": "file", "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "04e9b6b8-e9f0-41da-9941-85d45278aaed", "name": "La URL de descarga.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"string\",\n \"expiresAt\": \"1966-09-24T11:50:02.748Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3386ce10-0069-409a-a698-f3104e4a9312", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e640fe50-38f2-48f3-ac53-567092a8a81c", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "523df251-a4cd-4892-9a54-63d110656fce", "name": "`not_found`: el documento no existe en el ambiente de la llave. `file_not_available`: el archivo\ntodavía no existe; el XML y el PDF aparecen cuando la DIAN acepta el documento.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20d3d224-7a9f-42e8-87e8-5ba3e5c8ce9b", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "credit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Notas débito", "description": "Aumentan el valor de una factura aceptada por la DIAN, por ejemplo con intereses o gastos.", "item": [ { "id": "ddeb8b47-ca19-4b1d-b7aa-1a9bba292b53", "name": "Crear una nota débito", "request": { "name": "Crear una nota débito", "description": { "content": "Emite una nota débito sobre una factura aceptada por la DIAN, para cobrar un valor adicional. El cliente, la moneda y el pago se toman de la factura; las líneas son lo que la nota cobra. Responde 202 con estado `RECEIVED`; consulta el resultado con `GET /v1/debit-notes/{id}` o con el webhook `debit_note.accepted`.", "type": "text/plain" }, "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "{{$guid}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"{{invoiceId}}\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "89a10327-a708-4f5a-8e8d-0c978f772902", "name": "Nota recibida y encolada. Repetir la petición con la misma `Idempotency-Key` devuelve esta misma respuesta.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"id\": \"BcDd6AAF-A7e4-cbD6-6d5b-5A0CC384FC97\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"cf18dFD0-F8bf-659F-Fcb4-feDdd1e7dDbB\",\n \"number\": \"string\",\n \"status\": \"ACCEPTED\",\n \"cude\": \"string\",\n \"issueDate\": \"1949-01-05\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"C5dde930-db44-8dA9-Db50-7e1AdCB32B31\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"VALUE_CHANGE\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 7471.738510556937,\n \"taxExclusive\": 7663.947937990082,\n \"taxInclusive\": 9278.710751356655,\n \"payable\": 641.1455123638266\n },\n \"dian\": {\n \"statusCode\": \"string\",\n \"statusMessage\": \"string\",\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1981-04-03T00:02:46.877Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"1971-08-11T02:51:51.441Z\",\n \"deliveries\": [\n {\n \"id\": \"bCc3facc-Ec5f-12ba-c5bd-975f66A9DAbb\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"SENT\",\n \"error\": \"string\",\n \"sentAt\": \"2001-06-08T19:25:01.941Z\",\n \"lastEventAt\": \"1973-01-06T23:10:57.662Z\"\n },\n {\n \"id\": \"25AdEbE3-3379-1DC3-6fA0-D76FeE5fc06c\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"SENT\",\n \"error\": null,\n \"sentAt\": \"2014-01-07T14:25:18.032Z\",\n \"lastEventAt\": \"1988-09-26T11:20:23.701Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1cdb6ed-1d69-467c-96a5-c96e6415df9b", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eca51123-75a3-481e-bc53-b95b6fd4e651", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3f075a8-90a0-4b7a-ad3e-1e9359fff02e", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fee6eda7-2068-43d2-8df0-467049db1a8c", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c88353ff-627d-4010-a551-06a3e2052ab3", "name": "`idempotency_in_progress`: otra petición con la misma `Idempotency-Key` todavía se está\nprocesando. Reintenta en unos segundos.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea5a38ef-3e7f-429b-b6a5-bf542ffa98ae", "name": "La nota no se puede emitir:\n\n- `idempotency_mismatch`: la `Idempotency-Key` ya se usó con un cuerpo distinto.\n- `invoice_not_accepted`: la factura todavía no está aceptada por la DIAN.\n- `credit_note_exceeds_balance`: la nota crédito supera el saldo que le queda a la factura.\n- `credit_note_lines_required`: solo una anulación (`CANCELLATION`) puede omitir las líneas.\n- `issuer_not_ready`, `issuer_missing_software`, `issuer_missing_certificate`,\n `no_active_numbering_range`: el emisor no puede emitir este tipo de documento.\n- `lines_required`, `line_description_required`, `line_quantity_invalid`, `line_price_invalid`,\n `line_tax_invalid`, `amount_too_large`: alguna línea o el total no es válido.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "467eee1f-fd70-489c-a3b3-d6efcdc9aea0", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan.\n`sandbox_daily_limit`: la cuenta ya emitió los documentos de simulación del día; el límite se\nreinicia a medianoche, hora de Colombia. En ambos casos, espera los segundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "debit-notes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) Identificador único que eliges para esta emisión, por ejemplo un UUID o el número de tu pedido.\nSi la petición falla por red y la repites con la misma llave, Cetus devuelve el documento ya\ncreado en lugar de emitir otro. Vale por cuenta y ambiente.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "6f1c2a3e-4b5d-4e6f-8a9b-0c1d2e3f4a5b" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invoiceId\": \"0199f6b0-0a2e-7d41-8c3f-5e6a7b8c9d01\",\n \"concept\": \"INTEREST\",\n \"description\": \"Intereses por pago tardío\",\n \"lines\": [\n {\n \"itemCode\": \"INT-MORA\",\n \"description\": \"Intereses de mora de noviembre\",\n \"quantity\": 1,\n \"unitPrice\": 3500\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 202) {", " pm.collectionVariables.set(\"debitNoteId\", pm.response.json().id);", "}" ] } } ], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0548fbf5-8d49-4cdc-9089-83493cd0c29a", "name": "Consultar una nota débito", "request": { "name": "Consultar una nota débito", "description": { "content": "La nota con su estado ante la DIAN, la factura que corrige y sus entregas al cliente.", "type": "text/plain" }, "url": { "path": [ "v1", "debit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{debitNoteId}}", "key": "id", "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e9362131-f8f4-4ed5-8913-8d5d0a49f379", "name": "La nota.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"BcDd6AAF-A7e4-cbD6-6d5b-5A0CC384FC97\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"cf18dFD0-F8bf-659F-Fcb4-feDdd1e7dDbB\",\n \"number\": \"string\",\n \"status\": \"ACCEPTED\",\n \"cude\": \"string\",\n \"issueDate\": \"1949-01-05\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"C5dde930-db44-8dA9-Db50-7e1AdCB32B31\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"VALUE_CHANGE\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 7471.738510556937,\n \"taxExclusive\": 7663.947937990082,\n \"taxInclusive\": 9278.710751356655,\n \"payable\": 641.1455123638266\n },\n \"dian\": {\n \"statusCode\": \"string\",\n \"statusMessage\": \"string\",\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1981-04-03T00:02:46.877Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"1971-08-11T02:51:51.441Z\",\n \"deliveries\": [\n {\n \"id\": \"bCc3facc-Ec5f-12ba-c5bd-975f66A9DAbb\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"SENT\",\n \"error\": \"string\",\n \"sentAt\": \"2001-06-08T19:25:01.941Z\",\n \"lastEventAt\": \"1973-01-06T23:10:57.662Z\"\n },\n {\n \"id\": \"25AdEbE3-3379-1DC3-6fA0-D76FeE5fc06c\",\n \"channel\": \"EMAIL\",\n \"recipient\": \"string\",\n \"status\": \"SENT\",\n \"error\": null,\n \"sentAt\": \"2014-01-07T14:25:18.032Z\",\n \"lastEventAt\": \"1988-09-26T11:20:23.701Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b781243-351f-4ba1-a049-5ee6205839db", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b19e349-00e4-4769-a9a7-ef88f0bbb4f5", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45b71fec-27ef-4b92-9f39-cd0875e8d4e7", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d1e8aff-4bc5-4e03-a440-5e88e2dbc13a", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "91e4ea68-317e-4b45-b1d9-9185c8f79e72", "name": "Descargar un archivo de la nota débito", "request": { "name": "Descargar un archivo de la nota débito", "description": { "content": "Una URL temporal para descargar el XML firmado, el PDF o el AttachedDocument de la nota.", "type": "text/plain" }, "url": { "path": [ "v1", "debit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{debitNoteId}}", "key": "id", "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" } }, { "type": "any", "value": "pdf", "key": "file", "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "561af01a-5296-4d3f-9b32-24d1d966ced6", "name": "La URL de descarga.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"string\",\n \"expiresAt\": \"1966-09-24T11:50:02.748Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f05280b8-1891-4528-afd9-eb4e1a8c6e48", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "512f4054-e538-41bd-b53b-7c7a89526793", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f94abcc5-32c2-4854-ba1c-d5f5a82391ac", "name": "`not_found`: el documento no existe en el ambiente de la llave. `file_not_available`: el archivo\ntodavía no existe; el XML y el PDF aparecen cuando la DIAN acepta el documento.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81d3753a-c703-4f1b-8532-0ce77f0e2bfe", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "debit-notes", ":id", "files", ":file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) - `xml`: el XML firmado, tal como lo validó la DIAN.\n- `pdf`: la representación gráfica.\n- `attached-document`: el AttachedDocument que recibe el cliente, con el XML y la respuesta de la DIAN.\n (This can only be one of xml,pdf,attached-document)", "type": "text/plain" }, "type": "any", "value": "attached-document", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Emisores", "description": "Las empresas o personas que facturan con tu cuenta en el ambiente de la llave. Si solo uno puede\nemitir, los documentos lo toman sin enviar `issuerId`.\n", "item": [ { "id": "0566886c-d67a-41bc-bdca-49dd8d86d797", "name": "Listar los emisores", "request": { "name": "Listar los emisores", "description": { "content": "Los emisores de la cuenta en el ambiente de la llave. `readyToIssue` dice cuáles pueden emitir; con uno solo, los documentos pueden omitir `issuerId`.", "type": "text/plain" }, "url": { "path": [ "v1", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "640aa418-2b46-4d92-bd4f-3c8f91972639", "name": "Los emisores, del más antiguo al más reciente.", "originalRequest": { "url": { "path": [ "v1", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"id\": \"EfeC4fbC-63dC-EFFF-BcB4-F6bBea8064FA\",\n \"environment\": \"LIVE\",\n \"nit\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": null,\n \"status\": \"ONBOARDING\",\n \"readyToIssue\": true\n },\n {\n \"id\": \"B84AeAaa-C840-fBDD-feCD-8Ee0Bf0f9Fc2\",\n \"environment\": \"LIVE\",\n \"nit\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": null,\n \"status\": \"ONBOARDING\",\n \"readyToIssue\": false\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f078f1e-003a-41ef-b9a0-f991dfafba76", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0019b7d9-99d2-419f-b5f6-a59adbc2f1c3", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bccb9e23-ba35-46bd-8e57-22bd17aad2e8", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e93d9ea7-f170-4668-82b1-058e2547d85f", "name": "Consultar un emisor", "request": { "name": "Consultar un emisor", "description": {}, "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{issuerId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ad97d54d-64ad-4d0a-80a7-de329e4a7fb9", "name": "El emisor.", "originalRequest": { "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"03d27DeC-2Aa3-93dd-ddD2-A6b0ac3B4a82\",\n \"environment\": \"SANDBOX\",\n \"nit\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"status\": \"ENABLED\",\n \"readyToIssue\": true\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b979cb6-d506-47ee-9324-43d2c211f591", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24ca45c3-3659-4f30-9821-66e9e0678d45", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "43fea8c0-d2e5-4afd-af98-939831949ab6", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4fa6af5-7102-46c9-970b-426036993671", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Clientes", "description": "Clientes guardados para completar el adquiriente. Cada documento guarda su propia copia del\nadquiriente: cambiar un cliente no altera lo ya emitido.\n", "item": [ { "id": "44c3d29c-1aef-42ff-b06c-e50514f3b220", "name": "Listar los clientes", "request": { "name": "Listar los clientes", "description": { "content": "Del más reciente al más antiguo, por páginas: para la siguiente, envía el `nextCursor` de la anterior como `before`. `q` busca en el nombre o la identificación.", "type": "text/plain" }, "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos clientes devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "577eba83-c4ae-4739-9987-9d6c32db24e9", "name": "Una página de clientes.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos clientes devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "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\": \"EDd07200-E626-edEb-CA2a-da4226DAAfB4\",\n \"environment\": \"LIVE\",\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"PASSPORT\",\n \"identificationNumber\": \"string\",\n \"checkDigit\": null,\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"string\",\n \"string\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"string\",\n \"cityName\": \"string\",\n \"departmentCode\": \"string\",\n \"departmentName\": \"string\",\n \"postalCode\": \"string\",\n \"line\": \"string\",\n \"countryCode\": \"string\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": null,\n \"createdAt\": \"1980-09-26T05:38:05.625Z\",\n \"updatedAt\": \"2008-09-14T05:58:12.384Z\"\n },\n {\n \"id\": \"8Fb282d3-a637-1ACB-c4Ff-7fAE6dcc2D42\",\n \"environment\": \"LIVE\",\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"FOREIGNER_CARD\",\n \"identificationNumber\": \"string\",\n \"checkDigit\": null,\n \"legalName\": \"string\",\n \"tradeName\": null,\n \"taxLevelCodes\": [\n \"string\",\n \"string\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"string\",\n \"cityName\": \"string\",\n \"departmentCode\": \"string\",\n \"departmentName\": \"string\",\n \"postalCode\": null,\n \"line\": \"string\",\n \"countryCode\": \"string\",\n \"countryName\": \"string\"\n },\n \"email\": null,\n \"phone\": null,\n \"createdAt\": \"1970-08-17T15:17:39.761Z\",\n \"updatedAt\": \"1982-06-10T19:57:20.659Z\"\n }\n ],\n \"nextCursor\": \"6A7Abc8d-7eF2-EbFb-093A-318CF1eeEcBc\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14195e2e-3d34-418a-a93e-51556b95bc53", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos clientes devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6af1726f-c0c7-4fdf-a4c7-78b18e2d436d", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos clientes devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50e0189b-393a-4323-b6dd-cbfa45061204", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos clientes devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f20c4e20-b5e5-4dc1-ba5d-16718e7cd7b4", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos clientes devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0dbcbb85-eb56-4b2d-8e54-a482b1d79c5f", "name": "Crear un cliente", "request": { "name": "Crear un cliente", "description": {}, "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "20c7936b-92ed-4a41-b926-07ae03f5f48d", "name": "El cliente creado.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"48D5F134-Eb39-Bd86-0d8b-23CF88E5Af0F\",\n \"environment\": \"TEST\",\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"PASSPORT\",\n \"identificationNumber\": \"string\",\n \"checkDigit\": null,\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"string\",\n \"string\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"string\",\n \"cityName\": \"string\",\n \"departmentCode\": \"string\",\n \"departmentName\": \"string\",\n \"postalCode\": null,\n \"line\": \"string\",\n \"countryCode\": \"string\",\n \"countryName\": \"string\"\n },\n \"email\": null,\n \"phone\": null,\n \"createdAt\": \"1997-05-15T20:30:16.173Z\",\n \"updatedAt\": \"2015-01-02T14:14:43.909Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd300792-dd01-40e7-9d23-43eee6fab9fb", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fba42da3-bc8f-4349-a3fc-8d9b2a6ee4e4", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2964162c-652c-452d-9c0b-d12571f8f89c", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "722f24eb-09fb-4dfe-8263-f98f48dd5db2", "name": "- `customer_exists`: ya hay un cliente con ese tipo y número de identificación.\n- `customer_identification_invalid`, `customer_check_digit_invalid`: la identificación no tiene\n el formato de su tipo o el dígito de verificación no corresponde.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "547adcb8-ee4a-4cb5-93b0-f7530262069f", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"900123456\",\n \"checkDigit\": \"8\",\n \"legalName\": \"Distribuidora Andina SAS\",\n \"taxLevelCodes\": [\n \"O-13\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"11001\",\n \"cityName\": \"Bogotá, D.C.\",\n \"departmentCode\": \"11\",\n \"departmentName\": \"Bogotá\",\n \"line\": \"Calle 93 # 11-26\"\n },\n \"email\": \"facturas@andina.example\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 202) {", " pm.collectionVariables.set(\"customerId\", pm.response.json().id);", "}" ] } } ], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ad9e5dff-2363-49aa-865e-aee2e6ee4666", "name": "Reemplazar un cliente", "request": { "name": "Reemplazar un cliente", "description": { "content": "Reemplaza todos sus datos; lo que no se envíe queda vacío. No cambia los documentos ya emitidos.", "type": "text/plain" }, "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{customerId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1c59c844-979c-4e86-aa8b-49a3f90e799b", "name": "El cliente actualizado.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"48D5F134-Eb39-Bd86-0d8b-23CF88E5Af0F\",\n \"environment\": \"TEST\",\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"PASSPORT\",\n \"identificationNumber\": \"string\",\n \"checkDigit\": null,\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"string\",\n \"string\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"string\",\n \"cityName\": \"string\",\n \"departmentCode\": \"string\",\n \"departmentName\": \"string\",\n \"postalCode\": null,\n \"line\": \"string\",\n \"countryCode\": \"string\",\n \"countryName\": \"string\"\n },\n \"email\": null,\n \"phone\": null,\n \"createdAt\": \"1997-05-15T20:30:16.173Z\",\n \"updatedAt\": \"2015-01-02T14:14:43.909Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "de6f9880-b68e-43d9-9534-8c4ac60dbe52", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4862348b-68cd-4878-bc04-6b740e53d831", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5fe573aa-dd12-4e87-a4aa-438eed102516", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3760228-6256-4fd8-99f3-769534664b9f", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72ebca8d-d816-4e25-a724-4b28342b4ad9", "name": "- `customer_exists`: ya hay un cliente con ese tipo y número de identificación.\n- `customer_identification_invalid`, `customer_check_digit_invalid`: la identificación no tiene\n el formato de su tipo o el dígito de verificación no corresponde.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c02e5bf-0c09-4c1f-85bd-b32602554dcf", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"CITIZEN_ID\",\n \"identificationNumber\": \",\",\n \"legalName\": \"E\",\n \"checkDigit\": \"5\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"R-99-PN\",\n \"O-15\"\n ],\n \"taxScheme\": \"IVA\",\n \"address\": {\n \"municipalityCode\": \"nQcDC\",\n \"cityName\": \"{\",\n \"departmentCode\": \"EH\",\n \"departmentName\": \"x\",\n \"line\": \"k\",\n \"postalCode\": \"Lpd7649ZZM\",\n \"countryCode\": \"HX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"64696\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6467ae3b-64e4-45b6-a689-e47ad28dbaeb", "name": "Consultar un cliente", "request": { "name": "Consultar un cliente", "description": {}, "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{customerId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1ef6c9d5-fb03-4699-bce9-0a4199716312", "name": "El cliente.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"48D5F134-Eb39-Bd86-0d8b-23CF88E5Af0F\",\n \"environment\": \"TEST\",\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"PASSPORT\",\n \"identificationNumber\": \"string\",\n \"checkDigit\": null,\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"string\",\n \"string\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"string\",\n \"cityName\": \"string\",\n \"departmentCode\": \"string\",\n \"departmentName\": \"string\",\n \"postalCode\": null,\n \"line\": \"string\",\n \"countryCode\": \"string\",\n \"countryName\": \"string\"\n },\n \"email\": null,\n \"phone\": null,\n \"createdAt\": \"1997-05-15T20:30:16.173Z\",\n \"updatedAt\": \"2015-01-02T14:14:43.909Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e308a579-18e9-49aa-b844-8c8067f9bc89", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe8f6ac6-8529-4ef4-9955-598c238dded5", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffc8d346-082f-4f97-9ad9-d1cf1a9e3cb8", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5733040-3864-408f-8c3c-90d28cad8ae6", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1480e548-2104-4320-8b1d-b0d01fbc2580", "name": "Eliminar un cliente", "request": { "name": "Eliminar un cliente", "description": { "content": "No afecta los documentos ya emitidos.", "type": "text/plain" }, "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{customerId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "df909a67-f515-4535-81aa-22a0d7fc4a12", "name": "Eliminado.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e1204091-a15a-4e08-a073-3db62ba25e65", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb696343-2d62-4e6c-b59f-dab02bd92efb", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e32c5f8f-90a6-4ed1-b766-5ee77ca73e8f", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6663c53-795b-4979-b9b0-d6e6f0f33873", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Productos", "description": "Productos y servicios guardados para completar las líneas. Las líneas siguen enviando descripción,\nprecio e impuestos completos: el catálogo no se referencia desde los documentos.\n", "item": [ { "id": "71aafe43-902b-4250-922a-ba2133d14d9d", "name": "Listar los productos", "request": { "name": "Listar los productos", "description": { "content": "Del más reciente al más antiguo, por páginas: para la siguiente, envía el `nextCursor` de la anterior como `before`. `q` busca en el código o la descripción.", "type": "text/plain" }, "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos productos devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "edb69610-4aa4-48ea-be7f-27af5470219b", "name": "Una página de productos.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos productos devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "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\": \"2816C892-c6cB-F9e3-cF2B-6ae9aF2EdcD9\",\n \"environment\": \"TEST\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 5225.069677900203,\n \"taxes\": [\n {\n \"type\": \"INC\",\n \"percent\": 7229.606527436628\n },\n {\n \"type\": \"ICA\",\n \"percent\": 4618.581345671978\n }\n ],\n \"createdAt\": \"1990-11-16T16:35:04.024Z\",\n \"updatedAt\": \"1986-07-23T00:28:38.202Z\"\n },\n {\n \"id\": \"a66772B6-A39A-6EAE-6a3f-8F8AC57dD8E0\",\n \"environment\": \"SANDBOX\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 9200.716993528931,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 9501.34457898627\n },\n {\n \"type\": \"IVA\",\n \"percent\": 7535.993462042718\n }\n ],\n \"createdAt\": \"1969-03-26T19:30:25.880Z\",\n \"updatedAt\": \"1958-03-18T14:36:56.816Z\"\n }\n ],\n \"nextCursor\": \"7CFaeF4D-DbbA-b9b7-2B5b-C16CD58Bb0EA\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "434b74bc-8837-4c4f-a03a-69e919771c73", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos productos devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a7daab4-d847-4ef8-ac37-069d063da18d", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos productos devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef720187-c667-4983-8369-f65091a95c2e", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos productos devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca4757fb-8a0c-4dc5-8639-dd8a122a2c55", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "El `nextCursor` de la página anterior.", "type": "text/plain" }, "key": "before", "value": "dA06A14b-Bde3-9f6B-DDfB-dd2A44fDea25" }, { "disabled": false, "description": { "content": "Cuántos productos devolver, hasta 100.", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Texto a buscar.", "type": "text/plain" }, "key": "q", "value": "A" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0fc95eb4-c89a-409f-9d8a-ce4a3ab9832f", "name": "Crear un producto", "request": { "name": "Crear un producto", "description": {}, "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e9f267ae-20e0-4940-8162-c1b90f84be50", "name": "El producto creado.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"51f48A8B-aEeC-Ee00-c6A5-Cc019eDFd3D9\",\n \"environment\": \"TEST\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 2533.2028092181545,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 9892.602621954169\n },\n {\n \"type\": \"IVA\",\n \"percent\": 3870.4272972907947\n }\n ],\n \"createdAt\": \"1964-05-27T09:27:19.837Z\",\n \"updatedAt\": \"1951-12-14T18:20:24.566Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b658c9d0-8ad0-4d89-ac61-51580ec19e85", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94422358-8ba9-4bed-a18f-6abff3da461a", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bceeb693-0e92-49f2-9ce8-46d9f483b9c8", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1839fa02-4e76-45fd-a3c7-05986b81bed9", "name": "`product_exists`: ya hay un producto con ese código.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57caa0e0-68ea-4cd2-9aed-8bd31d9d141c", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"PROD-001\",\n \"description\": \"Caja de guantes de nitrilo\",\n \"unitCode\": \"94\",\n \"unitPrice\": 25000,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 19\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "if (pm.response.code === 201 || pm.response.code === 202) {", " pm.collectionVariables.set(\"productId\", pm.response.json().id);", "}" ] } } ], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "330e380e-a177-4319-aa87-fbdbb4e8f35a", "name": "Reemplazar un producto", "request": { "name": "Reemplazar un producto", "description": { "content": "Reemplaza todos sus datos; lo que no se envíe queda vacío. No cambia los documentos ya emitidos.", "type": "text/plain" }, "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{productId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "96bdbfed-7257-459d-af8e-3f6dd805f96b", "name": "El producto actualizado.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"51f48A8B-aEeC-Ee00-c6A5-Cc019eDFd3D9\",\n \"environment\": \"TEST\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 2533.2028092181545,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 9892.602621954169\n },\n {\n \"type\": \"IVA\",\n \"percent\": 3870.4272972907947\n }\n ],\n \"createdAt\": \"1964-05-27T09:27:19.837Z\",\n \"updatedAt\": \"1951-12-14T18:20:24.566Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb65b368-b483-4021-907d-1a038f0b7385", "name": "`invalid_request`: el cuerpo no es JSON válido, no corresponde al contrato o algún campo no cumple\nsus reglas. `errors` dice qué campo y por qué.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"about:blank\",\n \"title\": \"Bad Request\",\n \"status\": 400,\n \"detail\": \"The request is invalid\",\n \"instance\": \"/v1/invoices\",\n \"code\": \"invalid_request\",\n \"errors\": [\n {\n \"field\": \"lines[0].quantity\",\n \"message\": \"must be greater than 0\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50821cc8-d39c-483d-bec2-0b21fe17e440", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5dce2c0d-0643-4d65-8297-372ae80a8537", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "778c661a-c891-40b6-8bb2-de966317a03c", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d78e4aab-97c8-4514-9605-99f655edae51", "name": "`product_exists`: ya hay un producto con ese código.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ddea0a7d-f061-4547-aa5c-c768cb452fcf", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"s\",\n \"description\": \"&\",\n \"unitPrice\": 5468.014523,\n \"unitCode\": \"9J\",\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 72.3696\n },\n {\n \"type\": \"IVA\",\n \"percent\": 42.900800000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "79b7fedd-f4ce-4027-93d9-7107909c8ddc", "name": "Consultar un producto", "request": { "name": "Consultar un producto", "description": {}, "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{productId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "34fb346d-8f3c-4923-9c00-7f07423dd4a0", "name": "El producto.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"51f48A8B-aEeC-Ee00-c6A5-Cc019eDFd3D9\",\n \"environment\": \"TEST\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 2533.2028092181545,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 9892.602621954169\n },\n {\n \"type\": \"IVA\",\n \"percent\": 3870.4272972907947\n }\n ],\n \"createdAt\": \"1964-05-27T09:27:19.837Z\",\n \"updatedAt\": \"1951-12-14T18:20:24.566Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3a8f6ea-025e-4c3d-92f7-cc8bedd26d04", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7cf7a992-b16c-4289-84c4-0c6cd09a81a2", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e92c84a-6033-4bcd-a152-f3525ea719df", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef977d87-29c8-4e53-bbea-b253f6ff6dac", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6973c2a2-3630-4919-9dbf-e9feb732e853", "name": "Eliminar un producto", "request": { "name": "Eliminar un producto", "description": { "content": "No afecta los documentos ya emitidos.", "type": "text/plain" }, "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "{{productId}}", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "191dae67-e5f4-4b8b-a2e2-68fbfb06d105", "name": "Eliminado.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "246f7053-eec3-4170-9517-8d7db225281a", "name": "`unauthorized`: falta el encabezado `Authorization` o la llave no existe o fue revocada.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aeb14963-5c4e-4630-b999-f74da4d6fa48", "name": "`account_suspended`: la cuenta está suspendida y sus llaves no pueden operar.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f685bee9-ef2f-44e8-8b7a-eac36c4dc4b3", "name": "`not_found`: no existe en el ambiente de la llave. Un recurso de otro ambiente tampoco se encuentra.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-Id", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0b72991-8e83-4331-ad05-517248fc1c1e", "name": "`rate_limited`: superaste las solicitudes por segundo de tu llave o de tu plan. Espera los\nsegundos de `Retry-After`.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "bbda9e59-bcc9-98e5-3eea-c08d7066c441", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/problem+json" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "body": "{\n \"type\": \"string\",\n \"title\": \"string\",\n \"status\": 766,\n \"instance\": \"string\",\n \"code\": \"string\",\n \"detail\": \"string\",\n \"errors\": [\n {\n \"field\": \"string\",\n \"message\": \"string\"\n },\n {\n \"field\": \"string\",\n \"message\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://cetus-api.cantte.com", "type": "string" }, { "key": "apiKey", "value": "cetus_sandbox_", "type": "string" }, { "key": "invoiceId", "value": "", "type": "string" }, { "key": "creditNoteId", "value": "", "type": "string" }, { "key": "debitNoteId", "value": "", "type": "string" }, { "key": "issuerId", "value": "", "type": "string" }, { "key": "customerId", "value": "", "type": "string" }, { "key": "productId", "value": "", "type": "string" } ], "info": { "_postman_id": "8b2819fe-b680-40b2-a45c-d998895a0e3b", "name": "Cetus API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "Colección generada desde la especificación pública de Cetus. Pon tu llave de simulación en la variable apiKey; Idempotency-Key se genera en cada envío." }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] } }