{"info":{"name":"miPlata FACTURAR — API de documentos","description":"Colección generada a partir de la documentación pública (1.20). Defina {{baseUrl}} y {{apiKey}} en las variables de la colección.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"variable":[{"key":"baseUrl","value":"https://TU-EMPRESA.miplata.co/api/external","type":"string"},{"key":"apiKey","value":"TU_LLAVE","type":"string"}],"auth":{"type":"apikey","apikey":[{"key":"key","value":"X-API-Key","type":"string"},{"key":"value","value":"{{apiKey}}","type":"string"},{"key":"in","value":"header","type":"string"}]},"item":[{"name":"Endpoints","item":[{"name":"GET /health","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/health","host":["{{baseUrl}}"],"path":["health"]},"description":"Verifica que la llave es válida y se encuentra activa."}},{"name":"GET /company","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/company","host":["{{baseUrl}}"],"path":["company"]},"description":"Devuelve los datos del emisor."}},{"name":"POST /tokens","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/tokens","host":["{{baseUrl}}"],"path":["tokens"]},"description":"Crea un token de acceso personal asociado a la llave de origen.","body":{"mode":"raw","raw":"{\n  \"name\": \"ci-deploy\",\n  \"expires_in_days\": 30\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /tokens","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/tokens","host":["{{baseUrl}}"],"path":["tokens"]},"description":"Lista los tokens vigentes creados con esta llave."}},{"name":"DELETE /tokens/{id}","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/tokens/{id}","host":["{{baseUrl}}"],"path":["tokens",":id"],"variable":[{"key":"id","value":""}]},"description":"Revoca de inmediato el token indicado."}},{"name":"GET /customers","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/customers","host":["{{baseUrl}}"],"path":["customers"]},"description":"Lista paginada de adquirientes (page, limit; offset heredado). Filtros nit o nombre (q). Totales en X-Total-Count."}},{"name":"POST /customers","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/customers","host":["{{baseUrl}}"],"path":["customers"]},"description":"Crea un adquiriente. Si el NIT ya existe, responde 409.","body":{"mode":"raw","raw":"{\n  \"name\": \"Acme SAS\",\n  \"type_doc\": \"31\",\n  \"email\": \"pagos@acme.co\",\n  \"address\": \"Calle 100 # 20-30\",\n  \"city_code\": \"11001\",\n  \"department_code\": \"11\",\n  \"person_type\": \"1\",\n  \"tax_regime\": \"48\",\n  \"tax_level\": \"O-13\",\n  \"fiscal_responsibility\": \"O-13;O-15\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /customers/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/customers/{id}","host":["{{baseUrl}}"],"path":["customers",":id"],"variable":[{"key":"id","value":""}]},"description":"Consulta un adquiriente por su identificador."}},{"name":"PUT /customers/{id}","request":{"method":"PUT","header":[],"url":{"raw":"{{baseUrl}}/customers/{id}","host":["{{baseUrl}}"],"path":["customers",":id"],"variable":[{"key":"id","value":""}]},"description":"Actualiza un adquiriente."}},{"name":"DELETE /customers/{id}","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/customers/{id}","host":["{{baseUrl}}"],"path":["customers",":id"],"variable":[{"key":"id","value":""}]},"description":"Desactiva un adquiriente."}},{"name":"GET /customers/by-nit/{nit}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/customers/by-nit/{nit}","host":["{{baseUrl}}"],"path":["customers","by-nit",":nit"],"variable":[{"key":"nit","value":""}]},"description":"Consulta un adquiriente por documento de identificación."}},{"name":"PUT /customers/by-nit/{nit}","request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/customers/by-nit/{nit}","host":["{{baseUrl}}"],"path":["customers","by-nit",":nit"],"variable":[{"key":"nit","value":""}]},"description":"Crea o actualiza un adquiriente por NIT (sincronización).","body":{"mode":"raw","raw":"{\n  \"name\": \"Acme SAS\",\n  \"type_doc\": \"31\",\n  \"email\": \"pagos@acme.co\",\n  \"address\": \"Calle 100 # 20-30\",\n  \"city_code\": \"11001\",\n  \"department_code\": \"11\",\n  \"person_type\": \"1\",\n  \"tax_regime\": \"48\",\n  \"tax_level\": \"O-13\",\n  \"fiscal_responsibility\": \"O-13;O-15\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"POST /invoices","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/invoices","host":["{{baseUrl}}"],"path":["invoices"]},"description":"Crea una factura (01 venta, 02 exportación, 03 talonario/papel, 04 contingencia DIAN) o una nota (91/92) y la incorpora al flujo de transmisión ante la DIAN. Admite Idempotency-Key; un order_reference repetido en 01/02 responde 409.","body":{"mode":"raw","raw":"{\n  \"customer_nit\": \"900123456\",\n  \"items\": [\n    { \"description\": \"Consultoría de software\", \"quantity\": 10, \"unit_price\": 150000 }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /invoices/defaults","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/defaults","host":["{{baseUrl}}"],"path":["invoices","defaults"]},"description":"Valores por defecto de emisión de la empresa: enabled_operation_types, defaults (entorno, forma y medio de pago, días de plazo, notas, operation_type), catálogos payment_forms / payment_means y el adquiriente consumidor_final."}},{"name":"POST /invoices/bulk","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/invoices/bulk","host":["{{baseUrl}}"],"path":["invoices","bulk"]},"description":"Encola hasta 500 documentos para emisión asíncrona y devuelve un batch_id.","body":{"mode":"raw","raw":"{\n  \"items\": [\n    {\n      \"client_reference\": \"ORD-1001\",\n      \"invoice\": {\n        \"customer_nit\": \"900123456\",\n        \"items\": [\n          { \"description\": \"Consultoría de software\", \"quantity\": 10, \"unit_price\": 150000 }\n        ]\n      }\n    },\n    {\n      \"client_reference\": \"ORD-1002\",\n      \"invoice\": {\n        \"is_consumidor_final\": true,\n        \"items\": [\n          { \"description\": \"Venta de mostrador\", \"quantity\": 1, \"unit_price\": 50000 }\n        ]\n      }\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /invoices/bulk/{batch_id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/bulk/{batch_id}","host":["{{baseUrl}}"],"path":["invoices","bulk",":batch_id"],"variable":[{"key":"batch_id","value":""}]},"description":"Consulta el estado de un lote y el resultado de cada documento."}},{"name":"GET /invoices","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices","host":["{{baseUrl}}"],"path":["invoices"]},"description":"Lista paginada (page, limit ≤ 200) con filtros order_reference, invoice_number, customer_nit, dian_status, invoice_type (01/02/03/04/91/92/05/95), date_from, date_to, source. Totales en X-Total-Count."}},{"name":"GET /invoices/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}","host":["{{baseUrl}}"],"path":["invoices",":id"],"variable":[{"key":"id","value":""}]},"description":"Consulta una factura por su identificador. Incluye errors_explained (rechazo explicado) y dian_queue (estado de reintento) cuando aplican."}},{"name":"PUT /invoices/{id}","request":{"method":"PUT","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}","host":["{{baseUrl}}"],"path":["invoices",":id"],"variable":[{"key":"id","value":""}]},"description":"Corrige un documento RECHAZADO o con ERROR sobre el mismo número: reconstruye el XML, recalcula el CUFE, firma y reenvía (finalize + send_to_dian). 409 invoice_not_correctable si ya fue transmitido."}},{"name":"POST /invoices/{id}/retry-now","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/retry-now","host":["{{baseUrl}}"],"path":["invoices",":id","retry-now"],"variable":[{"key":"id","value":""}]},"description":"Transmite ahora un documento pendiente por indisponibilidad de la DIAN (no espera el siguiente ciclo de 30 min)."}},{"name":"POST /invoices/{id}/contingency-04","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/contingency-04","host":["{{baseUrl}}"],"path":["invoices",":id","contingency-04"],"variable":[{"key":"id","value":""}]},"description":"Reemite una factura pendiente como tipo 04 (contingencia DIAN) con el mismo número, para entregarla al cliente sin validación previa."}},{"name":"GET /invoices/{id}/attached-document","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/attached-document","host":["{{baseUrl}}"],"path":["invoices",":id","attached-document"],"variable":[{"key":"id","value":""}]},"description":"Descarga el AttachedDocument (XML firmado + ApplicationResponse de la DIAN) del documento aceptado."}},{"name":"GET /invoices/{id}/application-response","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/application-response","host":["{{baseUrl}}"],"path":["invoices",":id","application-response"],"variable":[{"key":"id","value":""}]},"description":"Descarga solo el ApplicationResponse (acuse) de la DIAN del documento aceptado, application/xml."}},{"name":"GET /invoices/{id}/pdf","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pdf","host":["{{baseUrl}}"],"path":["invoices",":id","pdf"],"variable":[{"key":"id","value":""}]},"description":"Descarga la representación gráfica (PDF). Si el documento está ACEPTADO se sirve desde caché."}},{"name":"POST /invoices/{id}/pay-link","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pay-link","host":["{{baseUrl}}"],"path":["invoices",":id","pay-link"],"variable":[{"key":"id","value":""}]},"description":"Emite (o devuelve) el enlace de pago «Ver y pagar» de una factura de venta o cotización abierta. 201 nuevo / 200 reutilizado; 409 paylink_not_eligible con reason."}},{"name":"GET /invoices/{id}/pay-link","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pay-link","host":["{{baseUrl}}"],"path":["invoices",":id","pay-link"],"variable":[{"key":"id","value":""}]},"description":"Estado del enlace de pago más reciente (pending, paid, locked, revoked, disputed; expired se calcula al vencer expires_at). 404 no_pay_link."}},{"name":"DELETE /invoices/{id}/pay-link","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pay-link","host":["{{baseUrl}}"],"path":["invoices",":id","pay-link"],"variable":[{"key":"id","value":""}]},"description":"Revoca el enlace vigente (el cliente pagó por otro medio, el pedido se canceló)."}},{"name":"POST /invoices/{id}/payments","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/payments","host":["{{baseUrl}}"],"path":["invoices",":id","payments"],"variable":[{"key":"id","value":""}]},"description":"Registra un pago recibido fuera de la pasarela (efectivo, transferencia) sobre una factura emitida: actualiza saldo y Cartera, no toca el XML. reference única por factura."}},{"name":"GET /invoices/{id}/payments","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/payments","host":["{{baseUrl}}"],"path":["invoices",":id","payments"],"variable":[{"key":"id","value":""}]},"description":"Recibos del documento y su saldo (total, retenciones, pagado, balance)."}},{"name":"GET /payments/receipts","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/receipts","host":["{{baseUrl}}"],"path":["payments","receipts"]},"description":"Recibos de toda la empresa (app, API y pasarela) por fechas y medio; company_id para otra empresa."}},{"name":"POST /payments/checkouts","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts","host":["{{baseUrl}}"],"path":["payments","checkouts"]},"description":"Crea un cobro (pay / pay_and_invoice) y devuelve checkout_url. Ver Cobrar desde su web."}},{"name":"GET /payments/checkouts/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts/{id}","host":["{{baseUrl}}"],"path":["payments","checkouts",":id"],"variable":[{"key":"id","value":""}]},"description":"Estado del cobro y su factura."}},{"name":"GET /payments/capabilities","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/capabilities","host":["{{baseUrl}}"],"path":["payments","capabilities"]},"description":"Estado de WAVA/PayPal, límites y dominios de retorno."}},{"name":"GET /ranges","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ranges","host":["{{baseUrl}}"],"path":["ranges"]},"description":"Lista las resoluciones de numeración vigentes."}},{"name":"POST /soporte","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/soporte","host":["{{baseUrl}}"],"path":["soporte"]},"description":"Crea un documento soporte (05) o su nota de ajuste (95). Admite Idempotency-Key.","body":{"mode":"raw","raw":"{\n  \"invoice_type\": \"05\",\n  \"customer_name\": \"Juan Pérez\",\n  \"customer_nit\": \"1020304050\",\n  \"customer_type_doc\": \"13\",\n  \"customer_city_code\": \"11001\",\n  \"customer_department_code\": \"11\",\n  \"payment_form\": \"1\",\n  \"payment_means_code\": \"10\",\n  \"items\": [\n    { \"description\": \"Servicio de mantenimiento\", \"quantity\": 1, \"unit_price\": 350000, \"tax_percent\": 0, \"tax_code\": \"01\" }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /soporte","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/soporte","host":["{{baseUrl}}"],"path":["soporte"]},"description":"Lista paginada de documentos soporte (05 y 95); mismos filtros que GET /invoices."}},{"name":"POST /payroll","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/payroll","host":["{{baseUrl}}"],"path":["payroll"]},"description":"Crea una nómina electrónica (102) o de ajuste (103). Admite Idempotency-Key (huella: empleado + periodo + tipo).","body":{"mode":"raw","raw":"{\n  \"document_type\": \"102\",\n  \"prefix\": \"NE\",\n  \"employee_doc_type\": \"13\",\n  \"employee_doc\": \"1020304050\",\n  \"employee_first_name\": \"Juan\",\n  \"employee_surname\": \"Pérez\",\n  \"employee_salary\": \"1750905\",\n  \"employee_contract_type\": \"1\",\n  \"period_start\": \"2026-09-01\",\n  \"period_end\": \"2026-09-30\",\n  \"payment_date\": \"2026-09-30\",\n  \"worked_days\": 30,\n  \"payment_method_code\": \"47\",\n  \"send_to_dian\": true\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /payroll","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payroll","host":["{{baseUrl}}"],"path":["payroll"]},"description":"Lista paginada de nómina electrónica; filtros employee_doc, dian_status, period (YYYY-MM)."}},{"name":"GET /payroll/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}","host":["{{baseUrl}}"],"path":["payroll",":id"],"variable":[{"key":"id","value":""}]},"description":"Consulta un documento de nómina electrónica. Incluye errors_explained y dian_queue cuando aplican."}},{"name":"PUT /payroll/{id}","request":{"method":"PUT","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}","host":["{{baseUrl}}"],"path":["payroll",":id"],"variable":[{"key":"id","value":""}]},"description":"Corrige una nómina RECHAZADA o con ERROR sobre el mismo consecutivo (nuevo CUNE) y la reenvía."}},{"name":"POST /payroll/{id}/retry-now","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}/retry-now","host":["{{baseUrl}}"],"path":["payroll",":id","retry-now"],"variable":[{"key":"id","value":""}]},"description":"Transmite ahora una nómina pendiente por indisponibilidad de la DIAN."}},{"name":"POST /payroll/{id}/sign","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}/sign","host":["{{baseUrl}}"],"path":["payroll",":id","sign"],"variable":[{"key":"id","value":""}]},"description":"Firma un borrador de nómina electrónica."}},{"name":"POST /payroll/{id}/send-to-dian","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}/send-to-dian","host":["{{baseUrl}}"],"path":["payroll",":id","send-to-dian"],"variable":[{"key":"id","value":""}]},"description":"Transmite la nómina electrónica a la DIAN."}},{"name":"GET /payroll/{id}/status","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}/status","host":["{{baseUrl}}"],"path":["payroll",":id","status"],"variable":[{"key":"id","value":""}]},"description":"Consulta el estado ante la DIAN por CUNE."}},{"name":"GET /payroll/{id}/pdf","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payroll/{id}/pdf","host":["{{baseUrl}}"],"path":["payroll",":id","pdf"],"variable":[{"key":"id","value":""}]},"description":"Descarga la representación gráfica de la nómina electrónica."}},{"name":"POST /events","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/events","host":["{{baseUrl}}"],"path":["events"]},"description":"Registra un evento RADIAN (eventos 030-034: acuse, reclamo, recibo del bien, aceptación expresa) sobre una factura de compra, identificado por CUFE. Valida el orden DIAN (409/422); 034 se rechaza con 422 event_not_allowed.","body":{"mode":"raw","raw":"{\n  \"cufe\": \"a1b2c3d4e5f6...(96 hex)\",\n  \"event_code\": \"030\",\n  \"receiver_person\": {\n    \"id_type\": \"13\",\n    \"id_number\": \"1020304050\",\n    \"first_name\": \"Laura\",\n    \"family_name\": \"Gómez Ruiz\",\n    \"job_title\": \"Jefe de compras\"\n  }\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET /events/{cufe}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/events/{cufe}","host":["{{baseUrl}}"],"path":["events",":cufe"],"variable":[{"key":"cufe","value":""}]},"description":"Consulta ante la DIAN el historial de eventos de una factura."}},{"name":"GET /usage","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/usage","host":["{{baseUrl}}"],"path":["usage"]},"description":"Consulta el plan y el cupo de documentos restante."}},{"name":"GET /maintenance","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/maintenance","host":["{{baseUrl}}"],"path":["maintenance"]},"description":"Ventana de mantenimiento vigente o próxima (o null). Nunca responde 503."}},{"name":"GET /webhooks","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/webhooks","host":["{{baseUrl}}"],"path":["webhooks"]},"description":"Lista los webhooks registrados."}},{"name":"POST /webhooks","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/webhooks","host":["{{baseUrl}}"],"path":["webhooks"]},"description":"Registra un webhook firmado; el secreto se exhibe una sola vez.","body":{"mode":"raw","raw":"{\n  \"name\": \"erp-produccion\",\n  \"url\": \"https://tu-erp.com/webhooks/miplata\",\n  \"events\": \"invoice.accepted,credit_note.*\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"PATCH /webhooks/{id}","request":{"method":"PATCH","header":[],"url":{"raw":"{{baseUrl}}/webhooks/{id}","host":["{{baseUrl}}"],"path":["webhooks",":id"],"variable":[{"key":"id","value":""}]},"description":"Modifica el nombre, la URL, los eventos o el estado de activación."}},{"name":"POST /webhooks/{id}/rotate","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/webhooks/{id}/rotate","host":["{{baseUrl}}"],"path":["webhooks",":id","rotate"],"variable":[{"key":"id","value":""}]},"description":"Genera un nuevo secreto de firma; se exhibe una sola vez."}},{"name":"DELETE /webhooks/{id}","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/webhooks/{id}","host":["{{baseUrl}}"],"path":["webhooks",":id"],"variable":[{"key":"id","value":""}]},"description":"Elimina un webhook y su historial de entregas."}},{"name":"GET /catalogs/departments","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/catalogs/departments","host":["{{baseUrl}}"],"path":["catalogs","departments"]},"description":"Departamentos DANE (código y nombre)."}},{"name":"GET /catalogs/departments/{code}/cities","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/catalogs/departments/{code}/cities","host":["{{baseUrl}}"],"path":["catalogs","departments",":code","cities"],"variable":[{"key":"code","value":""}]},"description":"Municipios DANE de un departamento."}},{"name":"GET /catalogs/invoice-types","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/catalogs/invoice-types","host":["{{baseUrl}}"],"path":["catalogs","invoice-types"]},"description":"Tipos de documento DIAN admitidos en la creación."}},{"name":"GET /catalogs/validate-nit","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/catalogs/validate-nit","host":["{{baseUrl}}"],"path":["catalogs","validate-nit"]},"description":"Valida un NIT y calcula su dígito de verificación."}}]},{"name":"Cobros (checkouts)","item":[{"name":"GET /payments/capabilities","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/capabilities","host":["{{baseUrl}}"],"path":["payments","capabilities"]},"description":"Modos, monedas, límites, dominios de retorno, paylinks (enlaces de pago activos) y estado de WAVA (wava.ready / wava.reason)."}},{"name":"POST /payments/buyer/validate","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payments/buyer/validate","host":["{{baseUrl}}"],"path":["payments","buyer","validate"]},"description":"Valida al comprador sin crear nada."}},{"name":"POST /payments/checkouts","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts","host":["{{baseUrl}}"],"path":["payments","checkouts"]},"description":"Crea el cobro: 201 con checkout_url."}},{"name":"GET /payments/checkouts/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts/{id}","host":["{{baseUrl}}"],"path":["payments","checkouts",":id"],"variable":[{"key":"id","value":""}]},"description":"Estado, factura y documentos."}},{"name":"GET /payments/checkouts?order_reference=","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts?order_reference=","host":["{{baseUrl}}"],"path":["payments","checkouts?order_reference="]},"description":"El cobro de un pedido."}},{"name":"POST /payments/checkouts/{id}/cancel","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts/{id}/cancel","host":["{{baseUrl}}"],"path":["payments","checkouts",":id","cancel"],"variable":[{"key":"id","value":""}]},"description":"Cancela un cobro no pagado."}},{"name":"POST /payments/checkouts/{id}/credit-note","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts/{id}/credit-note","host":["{{baseUrl}}"],"path":["payments","checkouts",":id","credit-note"],"variable":[{"key":"id","value":""}]},"description":"Nota crédito sobre la factura del cobro."}},{"name":"GET /payments/checkouts/{id}/documents/{pdf|xml|zip}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts/{id}/documents/{pdf|xml|zip}","host":["{{baseUrl}}"],"path":["payments","checkouts",":id","documents",":pdf|xml|zip"],"variable":[{"key":"id","value":""},{"key":"pdf|xml|zip","value":""}]},"description":"PDF, XML firmado o paquete."}},{"name":"POST /payments/checkouts/{id}/documents","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/payments/checkouts/{id}/documents","host":["{{baseUrl}}"],"path":["payments","checkouts",":id","documents"],"variable":[{"key":"id","value":""}]},"description":"Enlaces de un solo uso para el comprador (7 días)."}}]},{"name":"Enlaces de pago (Ver y pagar)","item":[{"name":"POST /invoices/{id}/pay-link","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pay-link","host":["{{baseUrl}}"],"path":["invoices",":id","pay-link"],"variable":[{"key":"id","value":""}]},"description":"Emite o devuelve el enlace (201 nuevo / 200 reutilizado)."}},{"name":"GET /invoices/{id}/pay-link","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pay-link","host":["{{baseUrl}}"],"path":["invoices",":id","pay-link"],"variable":[{"key":"id","value":""}]},"description":"Estado del enlace más reciente."}},{"name":"DELETE /invoices/{id}/pay-link","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/pay-link","host":["{{baseUrl}}"],"path":["invoices",":id","pay-link"],"variable":[{"key":"id","value":""}]},"description":"Revoca el enlace vigente."}}]},{"name":"Pagos recibidos fuera de la pasarela","item":[{"name":"POST /invoices/{id}/payments","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/payments","host":["{{baseUrl}}"],"path":["invoices",":id","payments"],"variable":[{"key":"id","value":""}]},"description":"Registra un pago recibido sobre una factura emitida (201; 200 si la reference ya existía)."}},{"name":"GET /invoices/{id}/payments","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/invoices/{id}/payments","host":["{{baseUrl}}"],"path":["invoices",":id","payments"],"variable":[{"key":"id","value":""}]},"description":"Recibos del documento (app, API y pasarela) con total, retenciones, pagado y saldo."}},{"name":"GET /payments/receipts","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/receipts","host":["{{baseUrl}}"],"path":["payments","receipts"]},"description":"Todos los recibos de la empresa en el entorno activo (date_from, date_to, payment_method; company_id para otra empresa; paginado)."}}]},{"name":"Conexiones de tienda","item":[{"name":"POST /api/connect/redeem","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/api/connect/redeem","host":["{{baseUrl}}"],"path":["api","connect","redeem"]},"description":"Canjea el código de conexión (sin X-API-Key ni firma X-MP previa; prueba de posesión + propiedad del dominio)."}},{"name":"POST /api/connect/rotate","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/api/connect/rotate","host":["{{baseUrl}}"],"path":["api","connect","rotate"]},"description":"Firma X-MP, no X-API-Key. Nueva clave pública; la anterior vale 10 minutos más."}},{"name":"POST /api/connect/health","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/api/connect/health","host":["{{baseUrl}}"],"path":["api","connect","health"]},"description":"Firma X-MP, no X-API-Key. Diagnóstico diario (versión, WAVA, SMTP, cron). Sin datos personales."}},{"name":"POST /api/connect/delivery-failed","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/api/connect/delivery-failed","host":["{{baseUrl}}"],"path":["api","connect","delivery-failed"]},"description":"Firma X-MP, no X-API-Key. La tienda no pudo enviar la factura (sin correo, SMTP)."}},{"name":"DELETE /api/connect/self","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/api/connect/self","host":["{{baseUrl}}"],"path":["api","connect","self"]},"description":"Firma X-MP, no X-API-Key. Revoca la conexión (desinstalación)."}}]},{"name":"Conectar ChatGPT y Claude (conector MCP) — requiere activación por miPlata","item":[{"name":"GET /.well-known/oauth-authorization-server","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/.well-known/oauth-authorization-server","host":["{{baseUrl}}"],"path":[".well-known","oauth-authorization-server"]},"description":"En mcp.miplata.co. Descubrimiento OAuth 2.1 (PKCE obligatorio)."}},{"name":"POST /mcp","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/mcp","host":["{{baseUrl}}"],"path":["mcp"]},"description":"En mcp.miplata.co. Endpoint MCP (Streamable HTTP) con token Bearer del conector."}}]},{"name":"Asistente de tienda (Lucas Tienda) — canal API","item":[{"name":"POST /v1/{bot}/answer","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/v1/{bot}/answer","host":["{{baseUrl}}"],"path":["v1",":bot","answer"],"variable":[{"key":"bot","value":""}]},"description":"En bot.miplata.co, X-Bot-Key. Una pregunta del cliente → respuesta estructurada."}},{"name":"POST /v1/{bot}/feedback","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/v1/{bot}/feedback","host":["{{baseUrl}}"],"path":["v1",":bot","feedback"],"variable":[{"key":"bot","value":""}]},"description":"En bot.miplata.co, X-Bot-Key. Pulgar arriba/abajo sobre una respuesta."}}]}]}