{ "item": [ { "name": "Facturas", "description": "Facturas electrónicas de venta. Se numeran con el rango activo del emisor.", "item": [ { "id": "4b691a88-69b6-4b82-8b4e-e46cd4664ec8", "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": "87bbd665-1890-4cab-a262-88d23965a2b9", "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": "bfd30b64-f079-45a4-bf60-a1e33d4dde1c", "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": "92f99290-b11b-4da1-83d2-0eb8932ebc66", "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\": 8651,\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": "03a0b265-9e27-4937-911f-60340bf5ec51", "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\": 8651,\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": "99f11069-ffb5-41e0-bdd5-7c4a34f8985d", "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\": 8651,\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": "ae68a22c-2f3f-49d4-84e4-941d118d32f9", "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": "3a17b6f4-d2d4-49b5-a483-5eb0993df63a", "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\": 8651,\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": "4bbb6ade-f87d-4abf-a298-edafc3df43a5", "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": "ad1e3d91-d398-4df2-bcad-7737eff048c7", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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": "ff59a760-dca0-4d8f-b4a1-ce0dbbd29249", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "fcbfa3c0-b7ba-4642-8c5d-9f0378a57ca1", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "f68c3f25-266b-4afa-86d2-e276e48035ad", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "ae08a41e-ac99-47de-8acb-92d9f64308f7", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "14d00b25-0254-4220-902a-75bac83fc055", "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": "52ef1aba-37e7-4c2b-88b9-8f8a14f4da0e", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"1998-05-05T02:17:59.434Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f12062fc-faad-4524-9b85-4ddba726f873", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "89af543c-b57a-4294-80dd-80b4e9fd1e06", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "fc54e72b-93a5-44ec-8265-959ae3909d1a", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "a3b6a834-8530-4a03-a020-c0f9aecb01a3", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "4ef01bda-094e-4e92-97de-d480670b6245", "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": "bd0631b8-2729-4743-86ea-54065f61fba3", "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\": \"E2f6be6B-eaed-43b6-EcF4-Eb51f1D71eBd\",\n \"environment\": \"LIVE\",\n \"issuerId\": \"884Ff3ba-8704-c8C0-d778-bda3E3b6f0f0\",\n \"number\": \"string\",\n \"status\": \"ACCEPTED\",\n \"cude\": \"string\",\n \"issueDate\": \"2020-12-07\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"F08CC6Cb-EDcF-bcc2-c4d2-A492ec51338A\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"EARLY_PAYMENT_DISCOUNT\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 2929.622492770214,\n \"taxExclusive\": 7631.740997846036,\n \"taxInclusive\": 886.6256695311969,\n \"payable\": 8936.092288176904\n },\n \"dian\": {\n \"statusCode\": null,\n \"statusMessage\": null,\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1988-02-14T23:59:23.551Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"1977-01-02T06:12:08.481Z\",\n \"deliveries\": [\n {\n \"id\": \"8a4EB10d-5167-c1D9-Bd31-9Ec213E19D14\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"SENT\",\n \"error\": \"string\",\n \"sentAt\": \"1981-06-10T11:19:22.562Z\",\n \"lastEventAt\": \"1948-04-06T15:13:36.414Z\"\n },\n {\n \"id\": \"DE85d21F-3EF6-7276-FFe6-0784C0E1C012\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"PENDING\",\n \"error\": \"string\",\n \"sentAt\": \"1978-07-17T12:57:09.096Z\",\n \"lastEventAt\": \"2015-06-25T18:37:00.592Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cc5cffd-8472-47fb-8123-171f937d1bd6", "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": "a418ca16-5c87-40dc-b31d-213fd0663b9f", "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\": 8651,\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": "25bbaf11-07a1-4033-b1be-25993c754997", "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\": 8651,\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": "905d1a33-d9e3-4077-8ef2-7a092092150e", "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\": 8651,\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": "9a028034-f5e2-478a-b0ee-2698b9bb4aac", "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\": 8651,\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": "914f22cc-2853-4412-b93d-0d121ca47fac", "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\": 8651,\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": "307a8aab-2dd5-4af3-aa9d-5453bd3fb6f8", "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\": 8651,\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": "082be0ee-48ef-4887-b313-112d6cc3ceb0", "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": "2b6ead35-d3ab-404e-9ed1-da1d3971af46", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"E2f6be6B-eaed-43b6-EcF4-Eb51f1D71eBd\",\n \"environment\": \"LIVE\",\n \"issuerId\": \"884Ff3ba-8704-c8C0-d778-bda3E3b6f0f0\",\n \"number\": \"string\",\n \"status\": \"ACCEPTED\",\n \"cude\": \"string\",\n \"issueDate\": \"2020-12-07\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"F08CC6Cb-EDcF-bcc2-c4d2-A492ec51338A\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"EARLY_PAYMENT_DISCOUNT\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 2929.622492770214,\n \"taxExclusive\": 7631.740997846036,\n \"taxInclusive\": 886.6256695311969,\n \"payable\": 8936.092288176904\n },\n \"dian\": {\n \"statusCode\": null,\n \"statusMessage\": null,\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1988-02-14T23:59:23.551Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"1977-01-02T06:12:08.481Z\",\n \"deliveries\": [\n {\n \"id\": \"8a4EB10d-5167-c1D9-Bd31-9Ec213E19D14\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"SENT\",\n \"error\": \"string\",\n \"sentAt\": \"1981-06-10T11:19:22.562Z\",\n \"lastEventAt\": \"1948-04-06T15:13:36.414Z\"\n },\n {\n \"id\": \"DE85d21F-3EF6-7276-FFe6-0784C0E1C012\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"PENDING\",\n \"error\": \"string\",\n \"sentAt\": \"1978-07-17T12:57:09.096Z\",\n \"lastEventAt\": \"2015-06-25T18:37:00.592Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a6468f6-63c1-4010-8580-7ab6db65b9d3", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "516a2ba6-7b4d-4da5-8d93-c888bf02567d", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "5c33e821-d9ee-427b-98ff-063c50d51429", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "1175f84c-0325-4a5b-9c63-8958f7be7f28", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "6ca6bf54-72ec-43f9-b7ad-c280e43be65c", "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": "e4b9521c-fb7a-4bc9-90c9-dbfda3812a10", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"1998-05-05T02:17:59.434Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8752e047-db19-4d02-9b19-94ed29d087de", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "a447a1ee-3250-4c6b-97da-2fcb3e1368b9", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "c55b0f53-e106-4be2-966c-9d1ca8dcffbf", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "c8f4d119-5d24-4291-95e8-b26131b10701", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "647b7235-8f35-4bb2-ba2a-ad0efe17f3a8", "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": "d8782afd-d79b-4256-9f7d-0b14aacc608c", "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\": \"8Dbd1826-d98f-A8aF-C3e2-BBEd71279b4A\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"229465d5-6a24-9bbc-6fAe-5501ee5c39BC\",\n \"number\": \"string\",\n \"status\": \"REJECTED\",\n \"cude\": \"string\",\n \"issueDate\": \"2015-01-09\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"9849f04A-72e1-bbEc-bbBd-DEaEC5b7ad7d\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"VALUE_CHANGE\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 1151.4195800642713,\n \"taxExclusive\": 2804.8640469136067,\n \"taxInclusive\": 2810.1468774000173,\n \"payable\": 5528.517604092424\n },\n \"dian\": {\n \"statusCode\": \"string\",\n \"statusMessage\": null,\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1975-08-06T07:29:39.132Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"2008-01-30T13:45:42.608Z\",\n \"deliveries\": [\n {\n \"id\": \"be6f46dC-71fD-2B94-10ED-0DFc8B0eE3E4\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"SKIPPED\",\n \"error\": \"string\",\n \"sentAt\": \"2011-04-19T21:01:31.456Z\",\n \"lastEventAt\": \"1971-05-22T13:44:09.677Z\"\n },\n {\n \"id\": \"e84D18d4-0576-CC1E-e70d-8fAAD0468231\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"PENDING\",\n \"error\": \"string\",\n \"sentAt\": \"1963-08-29T15:11:49.286Z\",\n \"lastEventAt\": \"1990-06-26T18:03:46.615Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4821c635-3a31-4620-b10e-8a7bfd3508f5", "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": "7a11549b-5019-4bd5-bc29-98f0d8b687d3", "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\": 8651,\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": "d066afba-261e-4140-8d7e-b75401ece178", "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\": 8651,\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": "3528d9a9-52a1-4086-8118-e7f285f9ba31", "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\": 8651,\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": "28ee2d92-c9d1-422b-9422-9ed873667bf8", "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\": 8651,\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": "85aee0e1-0af3-45aa-bf79-90b2ba058cd5", "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\": 8651,\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": "6336a6b6-b367-4077-8bf0-ac8c89031634", "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\": 8651,\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": "803f734e-c263-42b4-818b-26a64241dffe", "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": "5d5c6e03-83cf-4032-ab42-b026c7f51e0d", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"8Dbd1826-d98f-A8aF-C3e2-BBEd71279b4A\",\n \"environment\": \"SANDBOX\",\n \"issuerId\": \"229465d5-6a24-9bbc-6fAe-5501ee5c39BC\",\n \"number\": \"string\",\n \"status\": \"REJECTED\",\n \"cude\": \"string\",\n \"issueDate\": \"2015-01-09\",\n \"currency\": \"string\",\n \"invoice\": {\n \"id\": \"9849f04A-72e1-bbEc-bbBd-DEaEC5b7ad7d\",\n \"number\": \"string\",\n \"cufe\": \"string\"\n },\n \"concept\": \"VALUE_CHANGE\",\n \"description\": \"string\",\n \"totals\": {\n \"lineExtension\": 1151.4195800642713,\n \"taxExclusive\": 2804.8640469136067,\n \"taxInclusive\": 2810.1468774000173,\n \"payable\": 5528.517604092424\n },\n \"dian\": {\n \"statusCode\": \"string\",\n \"statusMessage\": null,\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"validatedAt\": \"1975-08-06T07:29:39.132Z\"\n },\n \"externalReference\": \"string\",\n \"createdAt\": \"2008-01-30T13:45:42.608Z\",\n \"deliveries\": [\n {\n \"id\": \"be6f46dC-71fD-2B94-10ED-0DFc8B0eE3E4\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"SKIPPED\",\n \"error\": \"string\",\n \"sentAt\": \"2011-04-19T21:01:31.456Z\",\n \"lastEventAt\": \"1971-05-22T13:44:09.677Z\"\n },\n {\n \"id\": \"e84D18d4-0576-CC1E-e70d-8fAAD0468231\",\n \"channel\": \"EMAIL\",\n \"recipient\": null,\n \"status\": \"PENDING\",\n \"error\": \"string\",\n \"sentAt\": \"1963-08-29T15:11:49.286Z\",\n \"lastEventAt\": \"1990-06-26T18:03:46.615Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6283962-414c-4995-a3ee-5eecfcb68e28", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "ddac666b-e2e7-4a99-8521-dcee3fcd3bbe", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "f1d56f5e-387b-4b85-b06f-ce60a4110525", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "1867c905-ef06-41c8-8270-7411b5bf40f7", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "3869219a-563d-482e-8295-66ce15ff1def", "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": "eeab998f-b84a-48de-84dd-49d6ac5d9c57", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"1998-05-05T02:17:59.434Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f77b9f4-2e3f-40eb-beec-850937e18a16", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "23772f5c-7fac-485d-bb33-a3b2c7bf8dbd", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "9b805aa7-1030-4844-96e6-3771b72680ee", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "027fce1f-5ee0-4419-afd8-e9c8d091d660", "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": "xml", "key": "file" }, { "disabled": false, "description": { "content": "(Required) El `id` que devolvió la creación del documento.", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "8243ccae-e58d-45db-ae8e-82f0a5aab502", "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": "6dac72d9-db9f-4d5e-bf1b-65453b4b0145", "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\": \"9ED976da-f9Ef-85FA-63fA-6a1eDf52f7a5\",\n \"environment\": \"SANDBOX\",\n \"nit\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"status\": \"TESTING\",\n \"readyToIssue\": false\n },\n {\n \"id\": \"FD893BB3-dAe6-2fFC-86df-aEe0e70DCE2b\",\n \"environment\": \"TEST\",\n \"nit\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": null,\n \"status\": \"DISABLED\",\n \"readyToIssue\": false\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48402b7a-3631-48d6-9f13-57e922cfad5b", "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\": 8651,\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": "bf2c1bdb-1083-469d-a0c1-4d824277fc69", "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\": 8651,\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": "58dce605-0196-41fd-b064-0492d117fe41", "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\": 8651,\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": "49ba24ea-3b35-445e-8914-1976358011e1", "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": "ce69df3e-6aa7-4149-b63f-d7647a6e233f", "name": "El emisor.", "originalRequest": { "url": { "path": [ "v1", "issuers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"BcdB29F7-0Ab8-AdB4-05b2-efc79Aaf3E2F\",\n \"environment\": \"LIVE\",\n \"nit\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": null,\n \"status\": \"ONBOARDING\",\n \"readyToIssue\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf3c0d91-1773-4747-8765-dab59d555b51", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "7cb166b7-9215-47a9-9409-8ed6ef1c4921", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "25cf14b6-fbb9-446e-8245-e4735ea49bbe", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "cd283793-af0b-4d47-9b69-df0c6c5da2fd", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "70acfa59-1b9a-424e-a282-e0140a4d1a6a", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d0e0c339-08df-4e8d-881c-edb9788f1c45", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": \"A55624fD-E55f-aACe-a9fE-C58cB5aFF8fe\",\n \"environment\": \"SANDBOX\",\n \"personType\": \"NATURAL_PERSON\",\n \"identificationType\": \"NIT\",\n \"identificationNumber\": \"string\",\n \"checkDigit\": \"string\",\n \"legalName\": \"string\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"string\",\n \"string\"\n ],\n \"taxScheme\": \"IVA\",\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\": \"string\",\n \"phone\": null,\n \"createdAt\": \"2017-01-13T03:52:14.404Z\",\n \"updatedAt\": \"2001-12-15T09:57:32.737Z\"\n },\n {\n \"id\": \"a99a0dB4-72f0-DAEb-DF7B-679Ab8DB8eaA\",\n \"environment\": \"SANDBOX\",\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"PEP\",\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\": \"string\",\n \"phone\": null,\n \"createdAt\": \"2009-02-15T11:59:05.441Z\",\n \"updatedAt\": \"1962-03-19T03:13:20.084Z\"\n }\n ],\n \"nextCursor\": \"DF5e8D37-1Ac7-43A1-EAbb-8F8522eC89CE\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "123e6779-874b-4541-9094-ac591d152cde", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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": "e8e35c45-f22f-478d-abc3-9518e3b5fae9", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": 8651,\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": "2f548c14-8755-490a-b1db-17bf2ec7a78f", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": 8651,\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": "0b39a9fe-b688-4358-beaf-8be78ad811aa", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": 8651,\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": "d389d006-5f82-43b0-9b44-b5974621dd4d", "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": "829f42e4-e50e-4ef3-84a0-95b90e5fe032", "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\": \"CCF32d44-5Cb5-EcBD-76e9-EfC83Db8C3fC\",\n \"environment\": \"TEST\",\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\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\": \"string\",\n \"createdAt\": \"1984-09-01T10:39:29.788Z\",\n \"updatedAt\": \"1980-08-19T09:44:07.262Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d37a373-0c8b-4c61-82cc-9097d2df2858", "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": "6d46200b-b954-489c-ba54-9a11e4181818", "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\": 8651,\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": "a0f5c26c-dbba-4962-8d0a-4c51d3096eef", "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\": 8651,\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": "3fb4f89f-c9d4-409f-a640-f0c101dc7e43", "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\": 8651,\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": "6c44bcd4-1498-4b7b-a1cf-df63856c0380", "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\": 8651,\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": "ba5c128b-6f9e-4b65-b8e3-ad21c6390b26", "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\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2ccd08b9-ed18-48c0-b75a-3fd7524cdee7", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"CCF32d44-5Cb5-EcBD-76e9-EfC83Db8C3fC\",\n \"environment\": \"TEST\",\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\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\": \"string\",\n \"createdAt\": \"1984-09-01T10:39:29.788Z\",\n \"updatedAt\": \"1980-08-19T09:44:07.262Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "196ee49f-9e23-4f29-a348-50923b59eba1", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\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": "4f1df759-6cfe-40b1-948a-a63ea8047c40", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\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\": 8651,\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": "622c3e85-ddd1-4c72-89de-94cfa2e1fff8", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\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\": 8651,\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": "f8eb2cf2-5cd2-4763-989a-ce94176a926f", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\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\": 8651,\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": "ff3eb945-538d-488a-83a8-2294e04e3bcf", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\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\": 8651,\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": "444bcf60-85d8-44c7-ac90-8ff464ee2000", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\n \"identificationNumber\": \"p\",\n \"legalName\": \"b\",\n \"checkDigit\": \"0\",\n \"tradeName\": \"string\",\n \"taxLevelCodes\": [\n \"O-47\",\n \"O-13\"\n ],\n \"taxScheme\": \"NOT_APPLICABLE\",\n \"address\": {\n \"municipalityCode\": \"O2rzbnH\",\n \"cityName\": \"k\",\n \"departmentCode\": \"LQp\",\n \"departmentName\": \"S\",\n \"line\": \"j\",\n \"postalCode\": \"Yx\",\n \"countryCode\": \"OX\",\n \"countryName\": \"string\"\n },\n \"email\": \"string\",\n \"phone\": \"(\"\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\": 8651,\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": "eb531bad-02e7-4a05-8a40-69a6bb79eda1", "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": "eafe113a-6bb2-43a1-90f5-b41b7b80bbe6", "name": "El cliente.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"CCF32d44-5Cb5-EcBD-76e9-EfC83Db8C3fC\",\n \"environment\": \"TEST\",\n \"personType\": \"LEGAL_ENTITY\",\n \"identificationType\": \"FOREIGNER_ID\",\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\": \"string\",\n \"createdAt\": \"1984-09-01T10:39:29.788Z\",\n \"updatedAt\": \"1980-08-19T09:44:07.262Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6d75559-4ad4-4c7e-9d8a-533156e77ac2", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "a8b15328-7d9c-4444-bbd7-671653cd1de4", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "58098630-b4eb-4143-9c95-cf7cb23f983f", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "b8eebfaa-7053-4ef3-b7d0-62aa7e6b3e11", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "78f7d1b0-e12a-4edd-b13b-9983c2a1dbe9", "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": "50e43e67-2823-471a-ba0e-4424edff8477", "name": "Eliminado.", "originalRequest": { "url": { "path": [ "v1", "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4db3568d-3ab6-4ca5-89d5-55d31e809753", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "eb022ef2-83f3-448d-a6f0-6ba950ed1a71", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "768220ce-0273-4878-a842-83ef7c1ea04e", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "fc812196-cbcd-457a-a9a8-702801e36b42", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "d8b9a1d4-fc26-4c04-99f7-7ecf64ff81f3", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "eb1ad00c-3e24-4970-a1c8-17579fcb6ff1", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": \"F8BcbEb3-8d51-BFcb-BC92-e47eE7aCec64\",\n \"environment\": \"LIVE\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 555.512609336325,\n \"taxes\": [\n {\n \"type\": \"IVA\",\n \"percent\": 3114.065942900528\n },\n {\n \"type\": \"INC\",\n \"percent\": 1854.1637936024858\n }\n ],\n \"createdAt\": \"1975-06-20T13:33:49.304Z\",\n \"updatedAt\": \"2023-06-15T18:57:14.891Z\"\n },\n {\n \"id\": \"B9B05AFC-bAa7-817A-2578-8d199A11E97C\",\n \"environment\": \"LIVE\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 3379.2112848020593,\n \"taxes\": [\n {\n \"type\": \"INC\",\n \"percent\": 4189.0328691127825\n },\n {\n \"type\": \"ICA\",\n \"percent\": 9233.234140366227\n }\n ],\n \"createdAt\": \"1973-05-01T23:35:20.178Z\",\n \"updatedAt\": \"2006-07-10T18:33:28.714Z\"\n }\n ],\n \"nextCursor\": \"6d6597cF-6FDc-3fD7-D1D1-d4ed4FEF1C76\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1768bfc6-6d08-4927-ae69-8965be07fa25", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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": "38d280bf-d205-49b9-8477-8b50ec748972", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": 8651,\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": "96843477-5157-4ba4-b01d-20758be817be", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": 8651,\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": "894ba050-3f43-4ead-a670-f4bced051fe2", "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": "cb1dA4d0-a50A-d5B9-c3BB-01F59BA9edFf" }, { "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": "H" } ], "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\": 8651,\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": "a14afbe7-7558-4747-a8d7-e13c03d7a361", "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": "98735f69-130a-4ab7-a911-50f330944dd0", "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\": \"CDeE4575-A346-6db2-4dAB-FE2a98CDE1F2\",\n \"environment\": \"LIVE\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 7870.168590281599,\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 3470.3514722750283\n },\n {\n \"type\": \"IVA\",\n \"percent\": 7598.992619247086\n }\n ],\n \"createdAt\": \"1952-02-12T21:45:46.618Z\",\n \"updatedAt\": \"1998-12-21T17:13:04.462Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b37ad50-4f28-459f-af80-b770f6587f70", "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": "4c62b855-b236-4550-b407-18f8c02cda44", "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\": 8651,\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": "aed9bf5b-80df-4247-b60f-a9d4b521eeda", "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\": 8651,\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": "ae0dfd5a-8fa9-47a9-a9e6-9eb5019a7a22", "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\": 8651,\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": "32b65889-a47f-482a-8eb3-b8c60d41e24b", "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\": 8651,\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": "122c515f-1fc0-4c3c-812d-b4b8f54cf9ef", "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\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a179653d-626b-4497-b059-28d486fea121", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"CDeE4575-A346-6db2-4dAB-FE2a98CDE1F2\",\n \"environment\": \"LIVE\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 7870.168590281599,\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 3470.3514722750283\n },\n {\n \"type\": \"IVA\",\n \"percent\": 7598.992619247086\n }\n ],\n \"createdAt\": \"1952-02-12T21:45:46.618Z\",\n \"updatedAt\": \"1998-12-21T17:13:04.462Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b1931b2-8123-4166-9074-198d42fa356a", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\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": "ebd062e7-e1c8-4710-853d-9d9eccce3d36", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\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\": 8651,\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": "bc0a7ae7-208f-4848-a98f-19a9b786360b", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\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\": 8651,\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": "9e8d0bc6-45a6-45b2-9df3-0e62c293458b", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\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\": 8651,\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": "d0413189-8895-4130-a84c-7012211baca8", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\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\": 8651,\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": "197efd14-6f42-4a7c-9189-1eb2084eaea8", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"B\",\n \"description\": \":\",\n \"unitPrice\": 3790.555918,\n \"unitCode\": \"Y\",\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 90.6362\n },\n {\n \"type\": \"ICA\",\n \"percent\": 48.672200000000004\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\": 8651,\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": "1e6d466c-d67e-480c-85fe-fc14ab861bee", "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": "00915737-18ac-4705-9eb4-6f1425f0f476", "name": "El producto.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": \"CDeE4575-A346-6db2-4dAB-FE2a98CDE1F2\",\n \"environment\": \"LIVE\",\n \"code\": \"string\",\n \"description\": \"string\",\n \"unitCode\": \"string\",\n \"unitPrice\": 7870.168590281599,\n \"taxes\": [\n {\n \"type\": \"ICA\",\n \"percent\": 3470.3514722750283\n },\n {\n \"type\": \"IVA\",\n \"percent\": 7598.992619247086\n }\n ],\n \"createdAt\": \"1952-02-12T21:45:46.618Z\",\n \"updatedAt\": \"1998-12-21T17:13:04.462Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6061e5db-21cb-4416-a0a4-86b3bdbc89eb", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "bf9d262d-7c4e-42f4-87f3-a983b8cd251a", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "cd822d06-5bb5-4ec4-a562-cebac6f04d92", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "289602de-0e55-44e9-8a42-f32eca403f26", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "1ae1c219-4c66-46f7-8d97-419eb991678d", "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": "cd64354b-31b8-42a0-abb4-16815257cc1b", "name": "Eliminado.", "originalRequest": { "url": { "path": [ "v1", "products", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "key": "id" } ] }, "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9ac885c8-4a1c-46b0-9216-53f189d5ecc1", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "eb6bc249-976c-4d00-bf1a-a99a428a0fbc", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "1f1ec433-0b3f-4849-a98f-90bf5d82ffe4", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "d4cd6438-1839-4c3c-9bc2-419ddfe9d574", "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": "2a350362-a1eb-03b5-16a2-5bb95f61af27", "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\": 8651,\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": "1f80c7fd-0e62-4c7f-b661-abac8d4acce3", "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" } ] } }