{ "info": { "_postman_id": "dd563f50-6044-51d0-96ab-d1912168e554", "name": "IndeFac API v1", "description": "API pública de IndeFac (/api/v1). Generado por sdk/tools/generate.mjs desde sdk/openapi/v1.json. No editar a mano: regenerar. Define las variables baseUrl y apiKey (llave ifk_...).", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "catalogs", "id": "9575ff6e-c013-53e0-86e6-d0bd8f7e600a", "item": [ { "name": "GET /api/v1/catalogs/communes", "id": "29a8e882-e5c0-5c13-8a48-e7364c960a8e", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/catalogs/communes", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "catalogs", "communes" ] } }, "response": [] }, { "name": "GET /api/v1/catalogs/document-types", "id": "4240fa45-51e1-5bb4-a880-203258872be7", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/catalogs/document-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "catalogs", "document-types" ] } }, "response": [] }, { "name": "GET /api/v1/catalogs/reference-types", "id": "1ed6269c-df2a-5d57-8def-c5a1f1c867b1", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/catalogs/reference-types", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "catalogs", "reference-types" ] } }, "response": [] }, { "name": "GET /api/v1/catalogs/taxes", "id": "5850faf1-8a1d-5ad9-b620-ca7cb9d37379", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/catalogs/taxes", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "catalogs", "taxes" ] } }, "response": [] }, { "name": "GET /api/v1/catalogs/units", "id": "06a70dc9-8334-5aa5-ba69-9d0d57c0e84b", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/catalogs/units", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "catalogs", "units" ] } }, "response": [] } ] }, { "name": "counterparties", "id": "fe7288a5-c429-50ed-8324-48b122ee0d9f", "item": [ { "name": "Clientes, con búsqueda por razón social o RUT", "id": "877c683a-9950-5d15-a599-9b582907f951", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/counterparties", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties" ], "query": [ { "key": "text", "value": "andes", "disabled": true }, { "key": "active", "value": "true", "disabled": true }, { "key": "page", "value": "1", "disabled": true }, { "key": "pageSize", "value": "50", "disabled": true } ] } }, "response": [] }, { "name": "Crea un cliente, o lo actualiza si el RUT ya existe", "id": "f68a96f1-53b4-5f3b-9813-a57a2c366cdd", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/counterparties", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties" ] }, "body": { "mode": "raw", "raw": "{\n \"rut\": \"76192083-9\",\n \"legalName\": \"Comercial Los Andes SpA\",\n \"businessLine\": \"Venta al por mayor de artículos de ferretería\",\n \"address\": \"Av. Providencia 1234\",\n \"commune\": \"Providencia\",\n \"city\": \"Santiago\",\n \"exchangeEmail\": \"dte@losandes.cl\",\n \"contactName\": \"María González\",\n \"isActive\": true,\n \"phone\": \"+56912345678\",\n \"whatsappOptIn\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET /api/v1/counterparties/export", "id": "4776c783-63cc-5055-96db-02bea54ebc2b", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/counterparties/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties", "export" ], "query": [ { "key": "text", "value": "andes", "disabled": true } ] } }, "response": [] }, { "name": "Importa clientes desde CSV", "id": "49ef5ff3-bffc-5db9-a6b0-0a7cdc7e642c", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/counterparties/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties", "import" ], "query": [ { "key": "dryRun", "value": "true", "disabled": true } ] }, "description": "multipart/form-data: file (CSV UTF-8, separador ; o ,, hasta 5.000 filas y 2 MB) y mode (upsert o insert). dryRun=true (por defecto) solo valida." }, "response": [] }, { "name": "GET /api/v1/counterparties/import/template", "id": "9cbe7d6f-4ce4-56ee-a3d5-8644e87f1dab", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/counterparties/import/template", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties", "import", "template" ] } }, "response": [] }, { "name": "GET /api/v1/counterparties/{id}", "id": "b2c599d5-d48b-57a2-af6f-732bc51cf314", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/counterparties/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "PUT /api/v1/counterparties/{id}", "id": "e0d46eb8-7c69-552b-8d87-7ce6e62c8b6b", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/counterparties/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"rut\": \"76192083-9\",\n \"legalName\": \"Comercial Los Andes SpA\",\n \"businessLine\": \"Venta al por mayor de artículos de ferretería\",\n \"address\": \"Av. Providencia 1234\",\n \"commune\": \"Providencia\",\n \"city\": \"Santiago\",\n \"exchangeEmail\": \"dte@losandes.cl\",\n \"contactName\": \"María González\",\n \"isActive\": true,\n \"phone\": \"+56912345678\",\n \"whatsappOptIn\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Elimina un cliente sin documentos (409 IN_USE si los tiene: se inactiva con PUT isActive=false)", "id": "4d65e72b-28ed-516c-ab50-baaf93233a2a", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/counterparties/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "counterparties", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] } ] }, { "name": "documents", "id": "2c8d3080-68d1-59bf-af45-e3145c0f4d1a", "item": [ { "name": "Busca documentos por tipo y folio, o por externalId", "id": "61ba2366-c526-5c19-afa4-937dc012b14a", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/documents", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents" ], "query": [ { "key": "type", "value": "33", "disabled": true }, { "key": "folio", "value": "1001", "disabled": true }, { "key": "externalId", "value": "PEDIDO-1001", "disabled": true }, { "key": "status", "value": "", "disabled": true }, { "key": "from", "value": "2026-01-01", "disabled": true }, { "key": "to", "value": "2026-01-31", "disabled": true }, { "key": "receiverRut", "value": "76192083-9", "disabled": true }, { "key": "page", "value": "1", "disabled": true }, { "key": "pageSize", "value": "50", "disabled": true }, { "key": "posId", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "disabled": true }, { "key": "sellerId", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "disabled": true }, { "key": "updatedSince", "value": "2026-01-15T09:00:00-03:00", "disabled": true } ] }, "description": "Con `updatedSince` (ISO 8601) devuelve solo lo que cambió después de esa fecha, ordenado por `updatedAt` e `id`: así un integrador se mantiene al día sin volver a leer todo. Máximo 200 por página." }, "response": [] }, { "name": "Emite un documento", "id": "d298187f-8a3d-5b87-a961-e0be703b3e13", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text", "description": "Repetir la misma llave con el mismo cuerpo devuelve el mismo documento." }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents" ] }, "body": { "mode": "raw", "raw": "{\n \"externalId\": \"PEDIDO-1001\",\n \"type\": 33,\n \"receiver\": {\n \"rut\": \"76192083-9\",\n \"name\": \"Comercial Los Andes SpA\",\n \"businessLine\": \"Venta al por mayor de artículos de ferretería\",\n \"address\": \"Av. Providencia 1234\",\n \"commune\": \"Providencia\",\n \"city\": \"Santiago\",\n \"email\": \"facturacion@losandes.cl\"\n },\n \"payment\": {\n \"form\": 1\n },\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"globalDiscounts\": [],\n \"references\": [],\n \"customFields\": {},\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Idempotente por Idempotency-Key o externalId. Si vienen totales se comparan con los calculados (TOTALS_MISMATCH si difieren en más de $1)." }, "response": [] }, { "name": "Factura guías de despacho: una factura con referencia a cada guía", "id": "29e4d000-dcec-51bf-8f9c-ce6ffe5e3f48", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/invoice-guides", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", "invoice-guides" ] }, "body": { "mode": "raw", "raw": "{\n \"guideIds\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"type\": 33,\n \"detail\": \"lines\",\n \"payment\": {\n \"form\": 1\n },\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { guideIds[], type?: 33|34, detail?: lines|summary, lines?, payment?, issueDate?, externalId?, sendEmail? }. Admite Idempotency-Key." }, "response": [] }, { "name": "GET /api/v1/documents/{id}", "id": "ad957c0c-5670-5d96-9fdf-ea138eafb41a", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Corrige montos: nota de crédito o débito con código de referencia 3", "id": "7c988f9a-b34d-5911-a8c4-4033a85a27ad", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/correct-amounts", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "correct-amounts" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"kind\": \"credit\",\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"text\": \"Corrige el precio de la línea 1\",\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { kind: credit|debit, lines[], text?, sendEmail? }. Admite Idempotency-Key." }, "response": [] }, { "name": "Corrige texto: nota de crédito con código de referencia 2", "id": "9fcdd1b3-dd47-54d8-b577-d61f2d3aa9a3", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/correct-text", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "correct-text" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"text\": \"Donde dice \\\"Av. Providencia 1234\\\" debe decir \\\"Av. Providencia 1243\\\"\",\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { text, sendEmail? }. Admite Idempotency-Key." }, "response": [] }, { "name": "POST /api/v1/documents/{id}/credit-note", "id": "709895d2-ddd3-509b-bd4b-2371da72bf7c", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/credit-note", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "credit-note" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"Anula el documento por error en el detalle\",\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST /api/v1/documents/{id}/debit-note", "id": "f3a343af-6a39-5976-b977-051527ad757b", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/debit-note", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "debit-note" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"Anula el documento por error en el detalle\",\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST /api/v1/documents/{id}/email", "id": "8a09e7e9-caa9-5687-b788-aed13708f0c5", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/email", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "email" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"to\": [\n \"facturacion@losandes.cl\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET /api/v1/documents/{id}/pdf", "id": "faf3ddf8-cade-5819-8211-00d761e4f668", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/pdf", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "pdf" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Envía el documento por WhatsApp", "id": "d5d98b1b-6664-515b-9c35-b057230205e3", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/send-whatsapp", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "send-whatsapp" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"phone\": \"+56912345678\",\n \"consent\": true\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { phone?, consent? }. Sin phone usa el de la ficha del cliente. Exige el consentimiento del receptor: el de su ficha (whatsappOptIn) o consent=true, que lo deja registrado. Teléfono en formato E.164 (Chile: +569 y ocho dígitos)." }, "response": [] }, { "name": "Estado en el SII, respuesta del receptor y eventos", "id": "a9d43bf4-7ff2-59e1-8b5c-baa12f1937f1", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "status" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Ticket térmico: HTML o bytes ESC/POS (Accept: application/octet-stream)", "id": "025628f0-f5d3-5913-8164-433dff190367", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/ticket", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "ticket" ], "query": [ { "key": "width", "value": "80", "disabled": true } ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "GET /api/v1/documents/{id}/xml", "id": "1bff60a7-c366-57cb-9e1d-60a916ad73c2", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/documents/:id/xml", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "documents", ":id", "xml" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] } ] }, { "name": "entitlements", "id": "6ecd6401-4fdf-596b-82c2-bb91f63923cf", "item": [ { "name": "Plan, estado de la suscripción, funciones y límites de la empresa", "id": "df86fe3f-92e3-5154-a0e7-8eb1aaf595cc", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/entitlements", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "entitlements" ] } }, "response": [] } ] }, { "name": "folios", "id": "b367d0d9-2e4b-5fc2-85a6-1e40b1afe1e7", "item": [ { "name": "GET /api/v1/folios", "id": "1239209c-1a0f-59d9-9814-e9a063fd5d94", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/folios", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "folios" ] } }, "response": [] } ] }, { "name": "items", "id": "212ec733-b3ac-58d1-a82f-8c3d09095d66", "item": [ { "name": "Productos, con búsqueda por nombre o código", "id": "87518b78-5af3-536f-bc63-4f851958b6a4", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/items", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items" ], "query": [ { "key": "text", "value": "andes", "disabled": true }, { "key": "active", "value": "true", "disabled": true }, { "key": "page", "value": "1", "disabled": true }, { "key": "pageSize", "value": "50", "disabled": true } ] } }, "response": [] }, { "name": "POST /api/v1/items", "id": "86dc3870-687c-53cd-afa0-6a52bf7082f1", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/items", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items" ] }, "body": { "mode": "raw", "raw": "{\n \"code\": \"SERV-001\",\n \"name\": \"Servicio de mantención mensual\",\n \"description\": \"Mantención preventiva de equipos, valor mensual\",\n \"unit\": \"UN\",\n \"price\": 100000,\n \"isExempt\": false,\n \"isActive\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET /api/v1/items/export", "id": "aa2e34e9-2759-515a-bd80-5f84586df37a", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/items/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items", "export" ], "query": [ { "key": "text", "value": "andes", "disabled": true } ] } }, "response": [] }, { "name": "Importa productos desde CSV", "id": "6833ba22-28e1-519a-812c-28a2dc90b9ce", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/items/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items", "import" ], "query": [ { "key": "dryRun", "value": "true", "disabled": true } ] }, "description": "multipart/form-data: file y mode (upsert o insert). La llave es el código; un producto sin código siempre se crea. dryRun=true (por defecto) solo valida." }, "response": [] }, { "name": "GET /api/v1/items/import/template", "id": "b2d1e89a-227d-5866-a58b-d9274a060f6b", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/items/import/template", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items", "import", "template" ] } }, "response": [] }, { "name": "GET /api/v1/items/{id}", "id": "acbadc2c-c7cb-5b32-9436-797ace6d60e9", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/items/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "PUT /api/v1/items/{id}", "id": "38bdf224-b116-540a-b7a5-90a4d6638df8", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/items/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"code\": \"SERV-001\",\n \"name\": \"Servicio de mantención mensual\",\n \"description\": \"Mantención preventiva de equipos, valor mensual\",\n \"unit\": \"UN\",\n \"price\": 100000,\n \"isExempt\": false,\n \"isActive\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "DELETE /api/v1/items/{id}", "id": "23201648-c62a-556f-a28b-34195d9eb5f5", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/items/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "items", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] } ] }, { "name": "me", "id": "3e0fced5-1046-5116-9a17-791e9f7aeeef", "item": [ { "name": "Empresa, ambiente, alcances y plan de la llave", "id": "7eed384a-1483-5dc1-b388-9302a428a9bd", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/me", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "me" ] } }, "response": [] } ] }, { "name": "quotes", "id": "d8dc448a-2a67-56f6-803d-30c08a4b4479", "item": [ { "name": "Cotizaciones, con filtros por estado, fecha y receptor", "id": "bfb1007e-812b-5031-b24d-b678c4d1a329", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/quotes", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes" ], "query": [ { "key": "status", "value": "", "disabled": true }, { "key": "text", "value": "andes", "disabled": true }, { "key": "from", "value": "2026-01-01", "disabled": true }, { "key": "to", "value": "2026-01-31", "disabled": true }, { "key": "receiverRut", "value": "76192083-9", "disabled": true }, { "key": "number", "value": "0", "disabled": true }, { "key": "page", "value": "1", "disabled": true }, { "key": "pageSize", "value": "50", "disabled": true } ] } }, "response": [] }, { "name": "Crea una cotización en borrador", "id": "539becd7-2d8a-56a0-a460-2f32735dfcd3", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes" ] }, "body": { "mode": "raw", "raw": "{\n \"receiver\": {\n \"rut\": \"76192083-9\",\n \"name\": \"Comercial Los Andes SpA\",\n \"businessLine\": \"Venta al por mayor de artículos de ferretería\",\n \"address\": \"Av. Providencia 1234\",\n \"commune\": \"Providencia\",\n \"city\": \"Santiago\",\n \"email\": \"facturacion@losandes.cl\"\n },\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"payment\": {\n \"form\": 1\n },\n \"validDays\": 15,\n \"notes\": \"Precios netos. Validez de la oferta: 15 días.\",\n \"externalId\": \"COT-1001\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { receiver, lines[], globalDiscounts?, references?, payment?, issueDate?, validUntil? | validDays?, notes?, externalId?, sellerId? | sellerCode? }. Precios netos, como en una factura." }, "response": [] }, { "name": "Calcula los totales de una cotización sin guardarla", "id": "0c6d2f08-9a2b-5d74-b553-ff74968f0845", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/preview", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", "preview" ] }, "body": { "mode": "raw", "raw": "{\n \"receiver\": {\n \"rut\": \"76192083-9\",\n \"name\": \"Comercial Los Andes SpA\",\n \"businessLine\": \"Venta al por mayor de artículos de ferretería\",\n \"address\": \"Av. Providencia 1234\",\n \"commune\": \"Providencia\",\n \"city\": \"Santiago\",\n \"email\": \"facturacion@losandes.cl\"\n },\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"payment\": {\n \"form\": 1\n },\n \"validDays\": 15,\n \"notes\": \"Precios netos. Validez de la oferta: 15 días.\",\n \"externalId\": \"COT-1001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET /api/v1/quotes/{id}", "id": "6331e216-bb2b-5416-8c1f-1ef875c01c35", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Cambia una cotización en borrador", "id": "96af6376-d2c8-57c4-8f7c-180439298f40", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"receiver\": {\n \"rut\": \"76192083-9\",\n \"name\": \"Comercial Los Andes SpA\",\n \"businessLine\": \"Venta al por mayor de artículos de ferretería\",\n \"address\": \"Av. Providencia 1234\",\n \"commune\": \"Providencia\",\n \"city\": \"Santiago\",\n \"email\": \"facturacion@losandes.cl\"\n },\n \"lines\": [\n {\n \"number\": 1,\n \"name\": \"Servicio de mantención mensual\",\n \"quantity\": 1,\n \"unit\": \"UN\",\n \"unitPrice\": 100000,\n \"exempt\": false,\n \"additionalTaxes\": [],\n \"amount\": 100000,\n \"customFields\": {}\n }\n ],\n \"payment\": {\n \"form\": 1\n },\n \"validDays\": 15,\n \"notes\": \"Precios netos. Validez de la oferta: 15 días.\",\n \"externalId\": \"COT-1001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "DELETE /api/v1/quotes/{id}", "id": "72ae8b29-3022-5a0a-a283-cfe1b4dd49a7", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Registra que el cliente aceptó (respuesta dada por otro medio)", "id": "21c945b3-62a5-5e51-9379-b902b3cc0028", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/accept", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "accept" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"María González\",\n \"comment\": \"Aprobada por gerencia\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Anula una cotización que aún no se convierte", "id": "a43dda6c-c621-5ae3-b7c2-96332cc3f6f8", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "cancel" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"El cliente desistió de la compra\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Convierte la cotización en un documento tributario", "id": "0bec77ac-20f8-5efc-b65d-be4e49289597", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/convert", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "convert" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"type\": 33,\n \"payment\": {\n \"form\": 1\n },\n \"sendEmail\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { type: 33|34|39|41|52, issueDate?, payment?, transport?, sendEmail?, externalId?, posId? | posCode? }. Emite con las mismas líneas y deja la relación en ambos sentidos. Repetirla no emite dos veces." }, "response": [] }, { "name": "Crea un borrador nuevo con el contenido de otra cotización", "id": "e1bcd5ad-9165-5392-9f2f-863dbf27630c", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/duplicate", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "duplicate" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "GET /api/v1/quotes/{id}/html", "id": "4cada8db-ba5d-58d6-addf-2b39eda3fea9", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/html", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "html" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "PDF de la cotización con su plantilla", "id": "3a193658-e00d-5161-9353-92e8850afdf4", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/pdf", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "pdf" ], "query": [ { "key": "download", "value": "true", "disabled": true } ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Registra que el cliente rechazó", "id": "2dab74ba-c72f-5244-b18d-75b78adcca82", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/reject", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "reject" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"María González\",\n \"comment\": \"Aprobada por gerencia\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Envía la cotización por correo con su PDF y el enlace de aceptación", "id": "b88f94e6-673b-5f64-9818-e00322d31853", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/quotes/:id/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "quotes", ":id", "send" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"to\": [\n \"facturacion@losandes.cl\"\n ],\n \"message\": \"Estimados: adjuntamos la cotización solicitada.\",\n \"markOnly\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Cuerpo: { to?[], message?, markOnly? }. Con markOnly=true solo la deja como enviada, sin correo." }, "response": [] } ] }, { "name": "received", "id": "d933dbda-3d36-5167-9701-6b6832c013d2", "item": [ { "name": "Documentos recibidos", "id": "e77c0a92-146f-5f47-b969-0140bb0fdb18", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/received", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "received" ], "query": [ { "key": "since", "value": "2026-01-01T00:00:00-03:00", "disabled": true }, { "key": "updatedSince", "value": "2026-01-15T09:00:00-03:00", "disabled": true }, { "key": "status", "value": "", "disabled": true }, { "key": "page", "value": "1", "disabled": true }, { "key": "pageSize", "value": "50", "disabled": true } ] }, "description": "`since` filtra por llegada; `updatedSince` trae lo que cambió (aceptado, reclamado, plazo vencido) ordenado por `updatedAt` e `id`. Máximo 200 por página." }, "response": [] }, { "name": "GET /api/v1/received/{id}", "id": "201bc554-1fa4-5432-9590-fd1e5e820f53", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/received/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "received", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "POST /api/v1/received/{id}/accept", "id": "bd64c076-f880-5462-a59e-4763a3da4edd", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/received/:id/accept", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "received", ":id", "accept" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"kind\": \"content\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST /api/v1/received/{id}/claim", "id": "cbd92932-05ff-559f-b76c-7f3fbaf441d0", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/received/:id/claim", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "received", ":id", "claim" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"Mercadería no recibida\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "PDF del documento recibido (representación de IndeFac a partir del XML)", "id": "d413d29c-c17d-58c1-9ef4-6854611cff91", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/received/:id/pdf", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "received", ":id", "pdf" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "GET /api/v1/received/{id}/xml", "id": "d36f89ae-867f-5ec3-9047-caa4d2ae072e", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/received/:id/xml", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "received", ":id", "xml" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] } ] }, { "name": "webhooks", "id": "1036c00f-e8a2-5901-919c-4ef8582d778a", "item": [ { "name": "Webhooks de la llave (alcance webhooks:read o webhooks:manage)", "id": "e0d0ffa1-46a9-5494-a93f-3bb5fc05a1d7", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "webhooks" ] } }, "response": [] }, { "name": "POST /api/v1/webhooks", "id": "dace8732-59a7-5919-b883-4129733e1e04", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/api/v1/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "webhooks" ] }, "body": { "mode": "raw", "raw": "{\n \"url\": \"https://erp.ejemplo.cl/webhooks/indefac\",\n \"events\": [\n \"document.accepted\",\n \"document.rejected\",\n \"quote.accepted\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Eventos que se pueden suscribir", "id": "7675aae7-b59b-56b6-bbf9-1eba77c21b91", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/webhooks/events", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "webhooks", "events" ] } }, "response": [] }, { "name": "DELETE /api/v1/webhooks/{id}", "id": "2c9dceca-b58a-534f-a574-56daa38d134f", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/webhooks/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "webhooks", ":id" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] } }, "response": [] }, { "name": "Entregas de un webhook", "id": "b7a8a8a1-eb89-55d4-bd69-c88debae2ce1", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/webhooks/:id/deliveries", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "webhooks", ":id", "deliveries" ], "query": [ { "key": "from", "value": "2026-01-01", "disabled": true }, { "key": "to", "value": "2026-01-31", "disabled": true }, { "key": "status", "value": "", "disabled": true }, { "key": "page", "value": "1", "disabled": true }, { "key": "pageSize", "value": "50", "disabled": true } ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" } ] }, "description": "Filtros `from`, `to` (fecha de creación) y `status` (queued, retrying, delivered, dead, forbidden)." }, "response": [] }, { "name": "Reenvía una entrega", "id": "778e7f02-3f22-5361-a194-2684f2aa3dfe", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/api/v1/webhooks/:id/deliveries/:deliveryId/redeliver", "host": [ "{{baseUrl}}" ], "path": [ "api", "v1", "webhooks", ":id", "deliveries", ":deliveryId", "redeliver" ], "variable": [ { "key": "id", "value": "", "description": "Parámetro de ruta id" }, { "key": "deliveryId", "value": "", "description": "Parámetro de ruta deliveryId" } ] }, "description": "Crea una entrega nueva con el mismo cuerpo y el mismo `eventId`. Máximo 60 reenvíos por hora por empresa." }, "response": [] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "http://localhost:5187", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" } ] }