{ "info": { "name": "API del puente SUNAT de Aion Media", "description": "Tu sistema calcula y numera el comprobante y lo envía en JSON con el **formato de los modelos de Greenter**, el estándar abierto para SUNAT.\nLo firmamos con el certificado de tu empresa, lo mandamos a SUNAT y te devolvemos el XML y el CDR.\n**No guardamos los archivos**: conservarlos es obligación de tu empresa.\n\n## Cómo empezar\n\n1. Crea tu cuenta y registra tu empresa eligiendo **Puente, desde mi propio sistema**. Queda con el plan\n gratis: 200 comprobantes al mes en producción, sin vencimiento.\n2. En **Configuración → SUNAT y certificado** sube tu certificado digital. En beta sirve el de prueba; para\n producción registra también tu usuario SOL secundario.\n3. En **Integraciones → API** crea un token. Es permanente y pertenece a una empresa: si emites para varias,\n usa un token por empresa.\n4. Envía siempre estas cabeceras:\n\n```\nAuthorization: Bearer \nAccept: application/json\nContent-Type: application/json\n```\n\n## Si ya usas el formato de Greenter\n\nSi tu sistema ya arma los comprobantes con los modelos de Greenter, solo cambia la dirección base por\n`https://puente.aionstoreperu.com/api/v1/bridge` y usa tu token de Aion. El token es permanente: no tienes que renovarlo cada día.\n\n## Límites\n\n- 120 peticiones por minuto por token (429 si te pasas).\n- Cupo del plan: cuentan los comprobantes que SUNAT procesó en producción (aceptados, observados o\n rechazados); un resumen o una baja cuenta sus líneas. Firmar el XML o sacar el PDF sin enviar no cuenta.\n- En beta hay un tope aparte de 50 envíos al mes.\n\n## Consultas de RUC y DNI\n\nEl mismo token sirve para consultar RUC y DNI si las activas en **Servicios** (ver su documentación).", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://puente.aionstoreperu.com/api/v1" }, { "key": "token", "value": "" } ], "item": [ { "name": "Modo puente", "item": [ { "name": "Enviar una factura o boleta ya calculada", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/invoice/send", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "invoice", "send" ], "query": [], "variable": [] }, "description": "", "body": { "mode": "raw", "raw": "{\n \"ublVersion\": \"2.1\",\n \"tipoOperacion\": \"0101\",\n \"tipoDoc\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"123\",\n \"fechaEmision\": \"2026-11-05T10:00:00-05:00\",\n \"formaPago\": {\n \"moneda\": \"PEN\",\n \"tipo\": \"Contado\"\n },\n \"tipoMoneda\": \"PEN\",\n \"client\": {\n \"tipoDoc\": \"6\",\n \"numDoc\": \"20100070970\",\n \"rznSocial\": \"BOTICA CENTRAL S.A.C.\",\n \"address\": {\n \"direccion\": \"AV. LOS OLIVOS 123\"\n }\n },\n \"mtoOperGravadas\": 100,\n \"mtoIGV\": 18,\n \"valorVenta\": 100,\n \"totalImpuestos\": 18,\n \"subTotal\": 118,\n \"mtoImpVenta\": 118,\n \"details\": [\n {\n \"codProducto\": \"P001\",\n \"unidad\": \"NIU\",\n \"descripcion\": \"PRODUCTO 1\",\n \"cantidad\": 2,\n \"mtoValorUnitario\": 50,\n \"mtoValorVenta\": 100,\n \"mtoBaseIgv\": 100,\n \"porcentajeIgv\": 18,\n \"igv\": 18,\n \"tipAfeIgv\": \"10\",\n \"totalImpuestos\": 18,\n \"mtoPrecioUnitario\": 59\n }\n ],\n \"legends\": [\n {\n \"code\": \"1000\",\n \"value\": \"SON CIENTO DIECIOCHO CON 00/100 SOLES\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Generar el XML firmado de una factura o boleta (sin enviar)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/invoice/xml", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "invoice", "xml" ], "query": [], "variable": [] }, "description": "" } }, { "name": "Generar el PDF de una factura o boleta (sin enviar)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/invoice/pdf", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "invoice", "pdf" ], "query": [], "variable": [] }, "description": "" } }, { "name": "Consultar el CDR de un comprobante enviado (solo producción)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/invoice/status", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "invoice", "status" ], "query": [ { "key": "tipo", "value": "", "disabled": true }, { "key": "serie", "value": "", "disabled": true }, { "key": "numero", "value": "", "disabled": true } ], "variable": [] }, "description": "" } }, { "name": "Enviar una nota de crédito o débito ya calculada", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/note/send", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "note", "send" ], "query": [], "variable": [] }, "description": "Igual que la factura, con `tipoDoc` `07` u `08`, `codMotivo`, `desMotivo`, `tipDocAfectado` y `numDocfectado` (sin `formaPago`)." } }, { "name": "Generar el XML firmado de una nota (sin enviar)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/note/xml", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "note", "xml" ], "query": [], "variable": [] }, "description": "" } }, { "name": "Generar el PDF de una nota (sin enviar)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/note/pdf", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "note", "pdf" ], "query": [], "variable": [] }, "description": "" } }, { "name": "Enviar un resumen diario de boletas (RC)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/summary/send", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "summary", "send" ], "query": [], "variable": [] }, "description": "`fecGeneracion` (fecha de las boletas), `fecResumen`, `correlativo`, `moneda` y `details` (`tipoDoc`, `serieNro`, `estado` 1 adiciona / 2 modifica / 3 anula, `clienteTipo`, `clienteNro`, `total`, `mtoOperGravadas`, `mtoIGV`, `porcentajeIgv`…). Devuelve un ticket." } }, { "name": "Generar el XML firmado de un resumen (sin enviar)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/summary/xml", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "summary", "xml" ], "query": [], "variable": [] }, "description": "" } }, { "name": "Consultar el ticket de un resumen", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/summary/status", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "summary", "status" ], "query": [ { "key": "ticket", "value": "", "disabled": true } ], "variable": [] }, "description": "" } }, { "name": "Enviar una comunicación de baja (RA)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/voided/send", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "voided", "send" ], "query": [], "variable": [] }, "description": "`fecGeneracion` (fecha de los comprobantes), `fecComunicacion`, `correlativo` y `details` (`tipoDoc`, `serie`, `correlativo`, `desMotivoBaja`). Devuelve un ticket." } }, { "name": "Generar el XML firmado de una baja (sin enviar)", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/voided/xml", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "voided", "xml" ], "query": [], "variable": [] }, "description": "" } }, { "name": "Consultar el ticket de una baja", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/bridge/voided/status", "host": [ "{{baseUrl}}" ], "path": [ "bridge", "voided", "status" ], "query": [ { "key": "ticket", "value": "", "disabled": true } ], "variable": [] }, "description": "" } } ] } ] }