{ "info": { "name": "Facturalo API", "description": "Documentación de Facturalo API v3: emite facturas, boletas, notas de crédito y débito y guías de remisión ante SUNAT con JSON. IGV automático, PDF/XML/CDR, webhooks firmados con reintentos, idempotencia, SIRE (RVIE/RCE) y consultas RUC/DNI. Base URL https://api.facturalo.pe/api/v3.\n\nGenerada desde https://docs.facturalo.pe. Compatible con Postman, Insomnia, Bruno y otros clientes HTTP.\n\n1. En Variables, reemplaza `bearerToken` por tu secret key real.\n2. Ejemplo de placeholder: `sk_test_…`. Demo: sk_test_… · Producción: sk_live_… · Cuenta (empresas): user_sk_….", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_postman_id": "facturalo-docs-collection" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.facturalo.pe/api/v3", "type": "string" }, { "key": "bearerToken", "value": "sk_test_…", "type": "string" } ], "item": [ { "name": "consulta", "item": [ { "name": "GET Consulta por DNI", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/dni/{dni}", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "dni", ":dni" ] }, "description": "Retorna los datos de una persona natural registrada en RENIEC a partir de su número de DNI.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Consulta de licencia de conducir", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/licencia/{dni}", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "licencia", ":dni" ] }, "description": "Retorna los datos de la licencia de conducir de una persona a partir de su número de DNI, incluyendo categoría, vigencia y estado.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Consulta de vehículo por placa", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/placa/{placa}", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "placa", ":placa" ] }, "description": "Retorna los datos técnicos de un vehículo registrado en el Ministerio de Transportes a partir de su número de placa.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Consulta SOAT por placa", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/placa/{placa}/soat", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "placa", ":placa", "soat" ] }, "description": "Retorna el estado del SOAT de un vehículo, incluyendo la compañía aseguradora, número de póliza y vigencia.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Consulta por RUC", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/ruc/{ruc}", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "ruc", ":ruc" ] }, "description": "Retorna los datos fiscales de una empresa o persona natural registrada en SUNAT a partir de su número de RUC.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET RUC — Establecimientos anexos", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/ruc/{ruc}/anexos", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "ruc", ":ruc", "anexos" ] }, "description": "Retorna la lista de establecimientos anexos (sucursales, depósitos, etc.) de un RUC registrados en SUNAT.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET RUC — Representantes legales", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/ruc/{ruc}/representantes", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "ruc", ":ruc", "representantes" ] }, "description": "Retorna la lista de representantes legales registrados en SUNAT para un RUC. Los datos personales pueden aparecer parcialmente enmascarados según la política de SUNAT.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Tipo de cambio", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/consulta/tipo-cambio", "host": [ "{{baseUrl}}" ], "path": [ "consulta", "tipo-cambio" ] }, "description": "Retorna el tipo de cambio dólar-sol publicado por la SBS. Sin parámetros retorna el del día actual; con el parámetro fecha retorna el de una fecha específica.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] } ] }, { "name": "documentos", "item": [ { "name": "GET Consultar documento", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/documentos/{id}", "host": [ "{{baseUrl}}" ], "path": [ "documentos", ":id" ] }, "description": "Retorna el estado actual de un documento. El `{id}` es el ID retornado al emitir o anular el documento.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Eventos del documento", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/documentos/{id}/eventos", "host": [ "{{baseUrl}}" ], "path": [ "documentos", ":id", "eventos" ] }, "description": "Retorna el historial de eventos de procesamiento de un documento: generación de XML, envío a SUNAT, respuesta de SUNAT y notificaciones por webhook. El `id` es el retornado al emitir el documento.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Anular documento", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/anular", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "anular" ] }, "description": "Anula un comprobante electrónico. El tipo de baja se elige solo según el comprobante: facturas y sus notas van por Comunicación de Baja (RA); boletas y sus notas, por Resumen Diario (RC).\n\nFactura y boleta responden con el mismo formato. Las diferencias de cada una están en [Anular factura](/documento/anular/factura) y [Anular boleta](/documento/anular/boleta).", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"motivo\": \"Error en los datos del cliente\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Anular Boleta", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/anular", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "anular" ] }, "description": "Anula una boleta electrónica, o una nota de crédito o débito de boleta, mediante un Resumen Diario (RC) con estado de baja. Facturalo envía el resumen a SUNAT en la misma petición y consulta su ticket de inmediato.\n\nLa respuesta es síncrona. Si SUNAT todavía no terminó de procesar el ticket, recibes `estado: EN_PROCESO`; confirma el resultado final con `GET /documentos/{id}`.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"motivo\": \"Error en los datos del cliente\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Anular Factura", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/anular", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "anular" ] }, "description": "Anula una factura electrónica, o una nota de crédito o débito de factura, mediante una Comunicación de Baja (RA). Facturalo envía la comunicación a SUNAT en la misma petición y consulta su ticket de inmediato.\n\nSUNAT acepta la comunicación de baja hasta 7 días calendario después de la fecha de emisión. Pasado ese plazo, emite una nota de crédito.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"motivo\": \"Error en los datos del cliente\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta al crédito", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta con formaPago CREDITO. Incluye el array cuotas.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CREDITO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"cuotas\": [\n {\n \"numero\": \"Cuota001\",\n \"monto\": 649,\n \"fechaPago\": \"2026-07-13\"\n },\n {\n \"numero\": \"Cuota002\",\n \"monto\": 649,\n \"fechaPago\": \"2026-08-13\"\n }\n ],\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Laptop Dell Inspiron 15\",\n \"cantidad\": 2,\n \"precioUnitario\": 590,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Mouse inalámbrico\",\n \"cantidad\": 2,\n \"precioUnitario\": 59,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Anticipo — Pago total (boleta)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta final que referencia los anticipos previos.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"2\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"anticipos\": [\n {\n \"tipoDocumento\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"monto\": 590\n }\n ],\n \"items\": [\n {\n \"cantidad\": 10,\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Servicio de consultoría\",\n \"precioUnitario\": 118,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Anticipo — Primer pago (boleta)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Primera boleta de anticipo (sunatTransaccion: 0104).", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0104\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"descripcion\": \"Anticipo por servicio - Primer pago\",\n \"precioUnitario\": 590,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta con descuento global", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta con descuento en el campo descuentoGlobal.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"descuentoGlobal\": 50,\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"PRODUCTO A\",\n \"cantidad\": 2,\n \"precioUnitario\": 200,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"PRODUCTO B\",\n \"cantidad\": 1,\n \"precioUnitario\": 100,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta con descuento por ítem", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta con descuento individual en el campo descuento de cada ítem.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Laptop Dell\",\n \"cantidad\": 2,\n \"precioUnitario\": 1000,\n \"descuento\": 100,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Mouse inalámbrico\",\n \"cantidad\": 5,\n \"precioUnitario\": 50,\n \"descuento\": 25,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta con detracción", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta sujeta a detracción (sunatTransaccion: 1001).", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"1001\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"detraccion\": {\n \"tipo\": \"037\",\n \"medioPago\": \"001\",\n \"ctaBanco\": \"00-000-000000\",\n \"porcentaje\": 12,\n \"monto\": 141.6\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"descripcion\": \"Servicio de consultoría empresarial\",\n \"precioUnitario\": 1180,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta en dólares", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta emitida en dólares americanos (moneda: USD).", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"USD\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"cantidad\": 2,\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Producto exportación\",\n \"precioUnitario\": 100,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta exonerada", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta con operaciones exoneradas del IGV (tipoIgv: '20').", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"moneda\": \"PEN\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"ARRENDAMIENTO DE INMUEBLE\",\n \"cantidad\": 1,\n \"precioUnitario\": 1500,\n \"tipoIgv\": \"20\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta de exportación", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta de exportación (sunatTransaccion: 0200, tipoIgv: 40). IGV 0%.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0200\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"USD\",\n \"cliente\": {\n \"tipoDocumento\": \"0\",\n \"numeroDocumento\": \"EXT123456\",\n \"denominacion\": \"FOREIGN CLIENT LLC\",\n \"direccion\": \"123 Main St, Miami, FL\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"SERVICIO DE EXPORTACION\",\n \"cantidad\": 1,\n \"precioUnitario\": 500,\n \"tipoIgv\": \"40\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta gratuita", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta por operaciones gratuitas. El precio unitario es 0 y tipoIgv es '11'.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"moneda\": \"PEN\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"MUESTRA GRATIS - PRODUCTO DEMO\",\n \"cantidad\": 2,\n \"precioUnitario\": 100,\n \"tipoIgv\": \"11\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta clásica (gravada)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Emite una boleta de venta electrónica gravada. Misma estructura que la factura pero con tipoComprobante: '03' y serie B001–B999.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"moneda\": \"PEN\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"SERVICIO DE CONSULTORÍA\",\n \"cantidad\": 2,\n \"precioUnitario\": 590,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"LAPTOP DELL INSPIRON\",\n \"cantidad\": 1,\n \"precioUnitario\": 3540,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta con guía de remisión", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta que referencia una guía de remisión.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"guias\": [\n {\n \"tipoDocumento\": \"09\",\n \"numeroDocumento\": \"T001-00000001\"\n }\n ],\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Producto con guía de remisión\",\n \"cantidad\": 3,\n \"precioUnitario\": 118,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta con ICBPER", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta con Impuesto al Consumo de Bolsas de Plástico. Agrega impuestoBolsa: true en el ítem.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Bolsa plástica pequeña\",\n \"cantidad\": 100,\n \"precioUnitario\": 1.18,\n \"tipoIgv\": \"10\",\n \"impuestoBolsa\": true\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Producto normal\",\n \"cantidad\": 2,\n \"precioUnitario\": 50,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Boleta inafecta", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Boleta con operaciones inafectas al IGV (tipoIgv: '30').", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"03\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"PRODUCTO INAFECTO AL IGV\",\n \"cantidad\": 2,\n \"precioUnitario\": 50,\n \"tipoIgv\": \"30\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de crédito (crédito)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de crédito de boleta con formaPago CREDITO. Incluye el array cuotas con las fechas y montos de pago.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"07\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CREDITO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"BOLETA\",\n \"documentoQueSeModificaSerie\": \"B001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeCredito\": \"01\",\n \"sustento\": \"Anulación de la operación\"\n },\n \"cuotas\": [\n {\n \"fechaPago\": \"2026-07-13\",\n \"monto\": 590\n },\n {\n \"fechaPago\": \"2026-08-13\",\n \"monto\": 590\n }\n ],\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"codigo\": \"S001\",\n \"descripcion\": \"Servicio de consultoría empresarial\",\n \"precioUnitario\": 1180,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de crédito (contado)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de crédito de boleta al contado. tipoComprobante: 07. Incluye el objeto nota con los datos del documento original.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"07\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"BOLETA\",\n \"documentoQueSeModificaSerie\": \"B001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeCredito\": \"01\",\n \"sustento\": \"Anulación de la operación\"\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"codigo\": \"S001\",\n \"descripcion\": \"Servicio de consultoría empresarial\",\n \"precioUnitario\": 1180,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de débito (crédito)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de débito de boleta con formaPago CREDITO. Incluye el array cuotas con las fechas y montos de pago.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"08\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CREDITO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"BOLETA\",\n \"documentoQueSeModificaSerie\": \"B001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeDebito\": \"02\",\n \"sustento\": \"Aumento de valor por ajuste de precio\"\n },\n \"cuotas\": [\n {\n \"fechaPago\": \"2026-07-13\",\n \"monto\": 118\n }\n ],\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"descripcion\": \"Ajuste de precio - Servicio de consultoría\",\n \"precioUnitario\": 236,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de débito (contado)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de débito de boleta al contado. tipoComprobante: 08. Incluye el objeto nota con los datos del documento original.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"08\",\n \"serie\": \"B001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"12345678\",\n \"denominacion\": \"NOMBRES Y APELLIDOS\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"persona@gmail.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"BOLETA\",\n \"documentoQueSeModificaSerie\": \"B001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeDebito\": \"02\",\n \"sustento\": \"Aumento de valor por ajuste de precio\"\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"descripcion\": \"Ajuste de precio - Servicio de consultoría\",\n \"precioUnitario\": 236,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura al crédito", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura con formaPago CREDITO. Incluye el array cuotas con fechaDePago e importe.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CREDITO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"cuotas\": [\n {\n \"numero\": \"Cuota001\",\n \"monto\": 649,\n \"fechaPago\": \"2026-07-13\"\n },\n {\n \"numero\": \"Cuota002\",\n \"monto\": 649,\n \"fechaPago\": \"2026-08-13\"\n }\n ],\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Laptop Dell Inspiron 15\",\n \"cantidad\": 2,\n \"precioUnitario\": 590,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Mouse inalámbrico\",\n \"cantidad\": 2,\n \"precioUnitario\": 59,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Anticipo — Pago total", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura final que referencia los anticipos previos. El array anticipos lista los comprobantes de anticipo emitidos, descontando su monto del total.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"2\",\n \"sunatTransaccion\": \"0101\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"anticipos\": [\n {\n \"tipoDocumento\": \"02\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"monto\": 590\n }\n ],\n \"items\": [\n {\n \"cantidad\": 10,\n \"unidadMedida\": \"NIU\",\n \"codigo\": \"P001\",\n \"descripcion\": \"Servicio de consultoría\",\n \"precioUnitario\": 118,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Anticipo — Primer pago", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Primera factura de anticipo (sunatTransaccion: 0104). Se emite al recibir un pago antes de la entrega del bien o servicio.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"sunatTransaccion\": \"0104\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"codigo\": \"ANT001\",\n \"descripcion\": \"Anticipo por servicio de consultoría - Primer pago\",\n \"precioUnitario\": 590,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura con descuento global", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura con descuento aplicado al total del comprobante en el campo descuentoGlobal.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"descuentoGlobal\": 50,\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"PRODUCTO A\",\n \"cantidad\": 2,\n \"precioUnitario\": 200,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"PRODUCTO B\",\n \"cantidad\": 1,\n \"precioUnitario\": 100,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura con descuento por ítem", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura con descuento aplicado a cada ítem individualmente en el campo descuento del ítem.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Laptop Dell\",\n \"cantidad\": 2,\n \"precioUnitario\": 1000,\n \"descuento\": 100,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Mouse inalámbrico\",\n \"cantidad\": 5,\n \"precioUnitario\": 50,\n \"descuento\": 25,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura con detracción", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura sujeta a detracción (sunatTransaccion: 1001). Incluye el objeto detraccion con tipo, medioPago, ctaBanco, porcentaje y monto.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"1001\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"detraccion\": {\n \"tipo\": \"037\",\n \"medioPago\": \"001\",\n \"ctaBanco\": \"00-000-000000\",\n \"porcentaje\": 12,\n \"monto\": 141.6\n },\n \"items\": [\n {\n \"unidadMedida\": \"ZZ\",\n \"codigo\": \"S001\",\n \"descripcion\": \"Servicio de consultoría empresarial\",\n \"cantidad\": 1,\n \"precioUnitario\": 1180,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura en dólares", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura emitida en dólares americanos (moneda: USD). SUNAT requiere el tipo de cambio vigente para registros contables.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"sunatTransaccion\": \"0101\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"USD\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"cantidad\": 2,\n \"unidadMedida\": \"NIU\",\n \"codigo\": \"P001\",\n \"descripcion\": \"Producto exportación\",\n \"precioUnitario\": 100,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura exonerada", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura con operaciones exoneradas del IGV. Usa tipoIgv: '20' en los ítems. Aplica a arrendamiento de inmuebles, servicios educativos, medicamentos, entre otros definidos en el Apéndice I de la Ley del IGV.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"moneda\": \"PEN\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"ARRENDAMIENTO DE INMUEBLE\",\n \"cantidad\": 1,\n \"precioUnitario\": 1500,\n \"tipoIgv\": \"20\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura de exportación", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura de exportación (sunatTransaccion: 0200). IGV 0%, moneda USD.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0200\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"USD\",\n \"cliente\": {\n \"tipoDocumento\": \"0\",\n \"numeroDocumento\": \"EXT123456\",\n \"denominacion\": \"FOREIGN CLIENT LLC\",\n \"direccion\": \"123 Main St, Miami, FL\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"SERVICIO DE EXPORTACION\",\n \"cantidad\": 1,\n \"precioUnitario\": 500,\n \"tipoIgv\": \"40\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura gratuita", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura por operaciones gratuitas. El precio unitario es 0 y tipoIgv es '11' (Gravado gratuito).", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"moneda\": \"PEN\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"MUESTRA GRATIS - PRODUCTO DEMO\",\n \"cantidad\": 2,\n \"precioUnitario\": 100,\n \"tipoIgv\": \"11\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura clásica (gravada)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Emite una factura electrónica gravada y la envía directamente a SUNAT. Los cálculos de IGV, subtotales y totales son automáticos — solo envía precioUnitario y tipoIgv.\n\nRecomendado: header Idempotency-Key (p. ej. el id de tu orden) para reintentar sin duplicar. Ver [Idempotencia](/idempotencia).", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"moneda\": \"PEN\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"SERVICIO DE CONSULTORÍA\",\n \"cantidad\": 2,\n \"precioUnitario\": 590,\n \"tipoIgv\": \"10\"\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"LAPTOP DELL INSPIRON\",\n \"cantidad\": 1,\n \"precioUnitario\": 3540,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura con guía de remisión", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura que referencia una guía de remisión. El array guias lista los comprobantes de traslado vinculados.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"guias\": [\n {\n \"tipoDocumento\": \"09\",\n \"numeroDocumento\": \"T001-00000001\"\n }\n ],\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Producto con guía de remisión\",\n \"cantidad\": 3,\n \"precioUnitario\": 118,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura con ICBPER", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura con Impuesto al Consumo de Bolsas de Plástico. Agrega impuestoBolsa: true en el ítem correspondiente.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Bolsa plástica pequeña\",\n \"cantidad\": 100,\n \"precioUnitario\": 1.18,\n \"tipoIgv\": \"10\",\n \"impuestoBolsa\": true\n },\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Producto normal\",\n \"cantidad\": 2,\n \"precioUnitario\": 50,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura inafecta", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura con operaciones inafectas al IGV. Usa tipoIgv: '30' en los ítems.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"0101\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"PRODUCTO INAFECTO AL IGV\",\n \"cantidad\": 2,\n \"precioUnitario\": 50,\n \"tipoIgv\": \"30\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de crédito (crédito)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de crédito con formaPago CREDITO. Incluye el array cuotas con las fechas y montos de pago.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"07\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CREDITO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"FACTURA\",\n \"documentoQueSeModificaSerie\": \"F001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeCredito\": \"01\",\n \"sustento\": \"Anulación de la operación\"\n },\n \"cuotas\": [\n {\n \"fechaPago\": \"2026-07-13\",\n \"monto\": 590\n },\n {\n \"fechaPago\": \"2026-08-13\",\n \"monto\": 590\n }\n ],\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"codigo\": \"S001\",\n \"descripcion\": \"Servicio de consultoría empresarial\",\n \"precioUnitario\": 1180,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de crédito (contado)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de crédito de factura al contado. tipoComprobante: 07. Incluye el objeto nota con los datos del documento original.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"07\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"FACTURA\",\n \"documentoQueSeModificaSerie\": \"F001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeCredito\": \"01\",\n \"sustento\": \"Anulación de la operación\"\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"codigo\": \"S001\",\n \"descripcion\": \"Servicio de consultoría empresarial\",\n \"precioUnitario\": 1180,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de débito (crédito)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de débito con formaPago CREDITO. Incluye el array cuotas con las fechas y montos de pago.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"08\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CREDITO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"FACTURA\",\n \"documentoQueSeModificaSerie\": \"F001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeDebito\": \"02\",\n \"sustento\": \"Aumento de valor por ajuste de precio\"\n },\n \"cuotas\": [\n {\n \"fechaPago\": \"2026-07-13\",\n \"monto\": 118\n }\n ],\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"descripcion\": \"Ajuste de precio - Servicio de consultoría\",\n \"precioUnitario\": 236,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Nota de débito (contado)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Nota de débito de factura al contado. tipoComprobante: 08. Incluye el objeto nota con los datos del documento original.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"documento\": {\n \"tipoComprobante\": \"08\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"nota\": {\n \"documentoQueSeModifica\": \"FACTURA\",\n \"documentoQueSeModificaSerie\": \"F001\",\n \"documentoQueSeModificaCorrelativo\": \"1\",\n \"tipoDeNotaDeDebito\": \"02\",\n \"sustento\": \"Aumento de valor por ajuste de precio\"\n },\n \"items\": [\n {\n \"cantidad\": 1,\n \"unidadMedida\": \"ZZ\",\n \"descripcion\": \"Ajuste de precio - Servicio de consultoría\",\n \"precioUnitario\": 236,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Factura con retención", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/documentos/enviar", "host": [ "{{baseUrl}}" ], "path": [ "documentos", "enviar" ] }, "description": "Factura sujeta a retención (sunatTransaccion: 2001). Incluye el objeto retencion con tipo y porcentaje.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"documento\": {\n \"sunatTransaccion\": \"2001\",\n \"tipoComprobante\": \"01\",\n \"serie\": \"F001\",\n \"correlativo\": \"1\",\n \"fechaEmision\": \"2026-06-13\",\n \"formaPago\": \"CONTADO\",\n \"otrosCampos\": [\n {\n \"label\": \"Cajero\",\n \"value\": \"Guillermo\"\n },\n {\n \"label\": \"Método de pago\",\n \"value\": \"Yape\"\n },\n {\n \"label\": \"Mesa\",\n \"value\": \"12\"\n }\n ],\n \"moneda\": \"PEN\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20000000001\",\n \"denominacion\": \"EMPRESA S.A.C.\",\n \"direccion\": \"AV. LIMA 123 - LIMA - LIMA - LIMA\",\n \"correo\": \"cliente@empresa.com\"\n },\n \"retencion\": {\n \"tipo\": \"01\",\n \"porcentaje\": 3\n },\n \"items\": [\n {\n \"unidadMedida\": \"NIU\",\n \"descripcion\": \"Servicio profesional\",\n \"cantidad\": 1,\n \"precioUnitario\": 2360,\n \"tipoIgv\": \"10\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "empresas", "item": [ { "name": "GET Listar empresas", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/empresas", "host": [ "{{baseUrl}}" ], "path": [ "empresas" ] }, "description": "Retorna todas las empresas asociadas al token de usuario autenticado. Incluye tokens y webhooks configurados por entorno.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Crear empresa", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas", "host": [ "{{baseUrl}}" ], "path": [ "empresas" ] }, "description": "Registra una nueva empresa. Retorna los tokens de demo y producción junto con los webhookSecret. Guárdalos — no se pueden recuperar, solo regenerar.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"empresa\": {\n \"ruc\": \"20614694557\",\n \"nombre\": \"CONSULTIA DIGITAL S.A.C.\",\n \"direccion\": \"AV. PRINCIPAL 123, PISO 4\",\n \"departamento\": \"LAMBAYEQUE\",\n \"provincia\": \"LAMBAYEQUE\",\n \"distrito\": \"LAMBAYEQUE\",\n \"codigoPostal\": \"140301\",\n \"sunat\": {\n \"solUsuario\": \"MODDATOS\",\n \"solClave\": \"moddatos\",\n \"clientId\": null,\n \"clientSecret\": null\n }\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "PATCH Actualizar establecimiento", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{empresaUuid}/establecimientos/{uuid}", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":empresaUuid", "establecimientos", ":uuid" ] }, "description": "Actualiza los datos de un establecimiento existente. Todos los campos son opcionales — envía solo lo que deseas cambiar. El logo acepta cualquier formato de imagen (PNG, WEBP, BMP, etc.) y se convierte automáticamente a JPEG con calidad 90 eliminando los metadatos EXIF. Para eliminar el logo envía `\"logo\": null`.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"establecimiento\": {\n \"nombre\": \"SUCURSAL NORTE\",\n \"direccion\": \"Av. Los Pinos 123\",\n \"departamento\": \"LIMA\",\n \"provincia\": \"LIMA\",\n \"distrito\": \"SAN ISIDRO\",\n \"codigoPostal\": \"150027\",\n \"celular\": \"987654321\",\n \"correo\": \"sucursal@empresa.com\",\n \"logo\": \"data:image/png;base64,iVBORw0KGgo...\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "PATCH Actualizar empresa", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{uuid}", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid" ] }, "description": "Actualiza los datos de una empresa existente. Todos los campos son opcionales — envía solo lo que deseas cambiar. Para `clientId` y `clientSecret` puedes enviar `null` explícitamente para limpiar el valor.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"empresa\": {\n \"nombre\": \"NUEVO NOMBRE S.A.C.\",\n \"direccion\": \"Nueva dirección 123\",\n \"departamento\": \"LIMA\",\n \"provincia\": \"LIMA\",\n \"distrito\": \"MIRAFLORES\",\n \"codigoPostal\": \"150048\",\n \"logo\": \"base64...\",\n \"produccion\": true,\n \"sunat\": {\n \"solUsuario\": \"NUEVO_USER\",\n \"solClave\": \"nueva_clave\",\n \"clientId\": \"client_id_api\",\n \"clientSecret\": \"client_secret_api\"\n }\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET Listar establecimientos", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/establecimientos", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "establecimientos" ] }, "description": "Retorna todos los establecimientos (sucursales) de la empresa. Usa el `id` del establecimiento en el campo `establecimiento` al emitir documentos para identificar qué sucursal emite.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Crear establecimiento", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/establecimientos", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "establecimientos" ] }, "description": "Crea un nuevo establecimiento (sucursal) para la empresa. El `id` retornado se usa en el campo `establecimiento` al emitir documentos para identificar qué sucursal emite.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"establecimiento\": {\n \"nombre\": \"SUCURSAL NORTE\",\n \"direccion\": \"AV. INDUSTRIAL 456\",\n \"departamento\": \"LA LIBERTAD\",\n \"provincia\": \"TRUJILLO\",\n \"distrito\": \"TRUJILLO\",\n \"codigoPostal\": \"13001\",\n \"celular\": \"987654321\",\n \"correo\": \"sucursal@empresa.com\",\n \"logo\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAAABmJLR0QA/wD/AP+gvaeTAAAA...\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Regenerar token de empresa", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/regenerar-token", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "regenerar-token" ] }, "description": "Invalida el token actual del entorno indicado y genera uno nuevo. Útil si el token fue comprometido. Actualiza el token en tu sistema inmediatamente — el anterior deja de funcionar.\n\nEsta acción es irreversible. El token anterior queda invalidado en el instante que se llama a este endpoint.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"entorno\": \"demo\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "PATCH Actualizar webhook", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/webhook", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "webhook" ] }, "description": "Configura las URLs de webhook para cada entorno. Los eventos se envían como `POST` con el body del documento procesado. Usa el `webhookSecret` para verificar la autenticidad del evento en tu servidor.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": {\n \"demo\": \"https://tuapp.com/webhook/facturalo\",\n \"prod\": \"https://tuapp.com/webhook/facturalo\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "PATCH Actualizar webhook", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/webhook", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "webhook" ] }, "description": "Configura las URLs de webhook para cada entorno. Los eventos se envían como `POST` con el body del documento procesado. Usa el `webhookSecret` para verificar la autenticidad del evento en tu servidor.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": {\n \"demo\": \"https://tuapp.com/webhook/facturalo\",\n \"prod\": \"https://tuapp.com/webhook/facturalo\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET Listar eventos webhook", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/webhook/eventos", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "webhook", "eventos" ] }, "description": "Retorna todos los eventos disponibles y su estado (activo/inactivo) por entorno.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "PATCH Activar / desactivar eventos", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/empresas/{uuid}/webhook/eventos", "host": [ "{{baseUrl}}" ], "path": [ "empresas", ":uuid", "webhook", "eventos" ] }, "description": "Activa o desactiva eventos webhook por entorno. Solo se modifican los eventos enviados en el payload — los demás permanecen igual.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"entorno\": \"demo\",\n \"eventos\": [\n {\n \"evento\": \"documento.correo.enviado\",\n \"activo\": true\n },\n {\n \"evento\": \"documento.correo.fallido\",\n \"activo\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET Listar documentos", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/empresas/documentos", "host": [ "{{baseUrl}}" ], "path": [ "empresas", "documentos" ] }, "description": "Retorna los documentos de la empresa paginados. Soporta filtros por establecimiento, fecha, tipo y estado.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] } ] }, { "name": "guias", "item": [ { "name": "GET Consultar guía", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/guias/{id}", "host": [ "{{baseUrl}}" ], "path": [ "guias", ":id" ] }, "description": "Retorna el estado y datos de una guía de remisión. El `{id}` es el ID retornado al emitir la guía.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Eventos de guía", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/guias/{id}/eventos", "host": [ "{{baseUrl}}" ], "path": [ "guias", ":id", "eventos" ] }, "description": "Retorna la línea de tiempo completa del procesamiento de una guía: desde la recepción hasta la respuesta de SUNAT y el envío del webhook. Útil para depurar el estado de una guía en proceso.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Guía remitente — transporte privado", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/guias/enviar", "host": [ "{{baseUrl}}" ], "path": [ "guias", "enviar" ] }, "description": "Guía de Remisión Remitente (serie T...) para transporte privado (tipoTransporte: '02'). En lugar de datos del transportista, se indican la placa del vehículo y los datos del chofer.\n\nPara transporte privado: datosTransportista solo requiere numeroPlaca. Los datos del chofer van en datosChofer con DNI, número de licencia, nombres y apellidos.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"guia\": {\n \"fechaEmision\": \"2026-06-13\",\n \"serie\": \"T001\",\n \"correlativo\": \"1\",\n \"tipoTransporte\": \"02\",\n \"motivoTraslado\": \"01\",\n \"observaciones\": \"ENTREGA DE MERCADERÍA SEGÚN ORDEN DE COMPRA\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20100070970\",\n \"denominacion\": \"EMPRESA DISTRIBUIDORA SAC\",\n \"correo\": \"compras@empresa.com\"\n },\n \"datosTraslado\": {\n \"fecha\": \"2026-06-14\",\n \"pesoBrutoTotal\": 150.5,\n \"pesoUnidadMedida\": \"KGM\",\n \"numeroBultos\": 10,\n \"indicadorDeEnvio\": \"01\"\n },\n \"datosTransportista\": {\n \"numeroPlaca\": \"ABC-123\"\n },\n \"datosChofer\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"45678901\",\n \"numeroLicencia\": \"Q45678901\",\n \"nombres\": \"JUAN CARLOS\",\n \"apellidos\": \"PÉREZ LÓPEZ\"\n },\n \"puntoPartida\": {\n \"ubigeo\": \"150101\",\n \"direccion\": \"AV. INDUSTRIAL 123, LIMA\"\n },\n \"puntoLlegada\": {\n \"ubigeo\": \"040101\",\n \"direccion\": \"JR. COMERCIO 456, AREQUIPA\"\n },\n \"items\": [\n {\n \"codigo\": \"PROD-001\",\n \"descripcion\": \"TELEVISOR LED 55 PULGADAS\",\n \"unidadMedida\": \"NIU\",\n \"cantidad\": 5\n }\n ],\n \"documentosRelacionados\": [\n {\n \"tipoDocumento\": \"01\",\n \"numeroDocumento\": \"F001-00000001\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Guía remitente — transporte público", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/guias/enviar", "host": [ "{{baseUrl}}" ], "path": [ "guias", "enviar" ] }, "description": "Emite una Guía de Remisión Remitente (serie T..., tipo 09) para transporte público. Requiere datos de la empresa transportista (RUC) y la fecha de entrega de bienes.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"guia\": {\n \"fechaEmision\": \"2026-06-14\",\n \"serie\": \"T001\",\n \"correlativo\": \"1\",\n \"tipoTransporte\": \"01\",\n \"motivoTraslado\": \"01\",\n \"observaciones\": \"ENTREGA DE MERCADERÍA SEGÚN ORDEN DE COMPRA\",\n \"cliente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20100070970\",\n \"denominacion\": \"EMPRESA DISTRIBUIDORA SAC\",\n \"correo\": \"compras@empresa.com\"\n },\n \"datosTraslado\": {\n \"fecha\": \"2026-06-14\",\n \"fechaEntregaBienes\": \"2026-06-14\",\n \"pesoBrutoTotal\": 150.5,\n \"pesoUnidadMedida\": \"KGM\",\n \"numeroBultos\": 10,\n \"indicadorDeEnvio\": \"01\"\n },\n \"datosTransportista\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20415932376\",\n \"denominacion\": \"TRANSPORTES RÁPIDOS SAC\",\n \"numeroMTC\": \"MTC-123456\"\n },\n \"puntoPartida\": {\n \"ubigeo\": \"150101\",\n \"direccion\": \"AV. INDUSTRIAL 123, LIMA\"\n },\n \"puntoLlegada\": {\n \"ubigeo\": \"040101\",\n \"direccion\": \"JR. COMERCIO 456, AREQUIPA\"\n },\n \"items\": [\n {\n \"codigo\": \"PROD-001\",\n \"descripcion\": \"TELEVISOR LED 55 PULGADAS\",\n \"unidadMedida\": \"NIU\",\n \"cantidad\": 5\n }\n ],\n \"documentosRelacionados\": [\n {\n \"tipoDocumento\": \"01\",\n \"numeroDocumento\": \"F001-00000001\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Guía de remisión transportista", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/guias/enviar", "host": [ "{{baseUrl}}" ], "path": [ "guias", "enviar" ] }, "description": "Emite una Guía de Remisión Transportista (serie V..., tipo 31). El tipo se detecta automáticamente de la serie: V... = transportista. Requiere datos del destinatario, remitente, vehículo y chofer.\n\nLa serie V... activa automáticamente el modo transportista (tipo 31). La serie T... genera una guía remitente (tipo 09). No se necesita ningún campo adicional para diferenciarlos.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"webhook\": false,\n \"guia\": {\n \"fechaEmision\": \"2026-06-13\",\n \"serie\": \"V001\",\n \"correlativo\": \"1\",\n \"motivoTraslado\": \"01\",\n \"observaciones\": \"TRANSPORTE DE MERCADERÍA\",\n \"destinatario\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20100070970\",\n \"denominacion\": \"EMPRESA DISTRIBUIDORA SAC\"\n },\n \"remitente\": {\n \"tipoDocumento\": \"6\",\n \"numeroDocumento\": \"20601476551\",\n \"denominacion\": \"EMPRESA REMITENTE SAC\"\n },\n \"datosTraslado\": {\n \"fecha\": \"2026-06-14\",\n \"pesoBrutoTotal\": 150.5,\n \"pesoUnidadMedida\": \"KGM\",\n \"numeroBultos\": 10\n },\n \"datosVehiculo\": {\n \"numeroPlaca\": \"ABC-123\"\n },\n \"datosChofer\": {\n \"tipoDocumento\": \"1\",\n \"numeroDocumento\": \"45678901\",\n \"numeroLicencia\": \"Q45678901\",\n \"nombres\": \"JUAN CARLOS\",\n \"apellidos\": \"PÉREZ LÓPEZ\"\n },\n \"puntoPartida\": {\n \"ubigeo\": \"150101\",\n \"direccion\": \"AV. INDUSTRIAL 123, LIMA\"\n },\n \"puntoLlegada\": {\n \"ubigeo\": \"040101\",\n \"direccion\": \"JR. COMERCIO 456, AREQUIPA\"\n },\n \"items\": [\n {\n \"codigo\": \"PROD-001\",\n \"descripcion\": \"TELEVISOR LED 55 PULGADAS\",\n \"unidadMedida\": \"NIU\",\n \"cantidad\": 5\n }\n ],\n \"documentosRelacionados\": [\n {\n \"tipoDocumento\": \"09\",\n \"numeroDocumento\": \"T001-00000001\"\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POST Consultar ticket", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/guias/ticket", "host": [ "{{baseUrl}}" ], "path": [ "guias", "ticket" ] }, "description": "Las guías de remisión se procesan de forma asíncrona por SUNAT. Este endpoint consulta el resultado usando el `ticket` retornado al emitir la guía.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"ticket\": \"DEMO-20260613-043550\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "sire", "item": [ { "name": "POST Aceptar propuesta", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/aceptar-propuesta", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "aceptar-propuesta" ] }, "description": "Acepta la propuesta de compras de SUNAT tal cual y avanza el período a Preliminar Registrado.\n\n¡Atención! Esta acción se ejecuta directamente en SUNAT y mueve el período a Preliminar Registrado. Si necesitas revertirlo, usa el endpoint Eliminar preliminar registrado antes de que el período avance a un estado irreversible.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Comprobantes", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/comprobantes", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "comprobantes" ] }, "description": "Lista paginada de los comprobantes de compras del período. Sin fechas incluye también los emitidos en meses anteriores que SUNAT incorporó al período. Con fecEmisionIni y fecEmisionFin queda el mismo recorte que el filtro Fecha de emisión del portal.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Iniciar conciliación", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/conciliar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "conciliar" ] }, "description": "Compara los comprobantes de compras de SUNAT contra los registrados en Facturalo e identifica diferencias de estado y montos.\n\nNo requiere body. Retorna de inmediato un conciliacionId — úsalo en el endpoint Consultar conciliación para obtener el resultado cuando el proceso termine.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "PUT Eliminar preliminar", "request": { "method": "PUT", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/eliminar-preliminar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "eliminar-preliminar" ] }, "description": "Revierte el período de estado Preliminar a Propuesta.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "PUT Eliminar preliminar registrado", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/eliminar-preliminar-registrado", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "eliminar-preliminar-registrado" ] }, "description": "Deshace la acción de Aceptar propuesta y regresa el período al estado Propuesta.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"7b42c1f9b15a15e430ea55c9\",\n \"codTipoRegistro\": \"3\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET Exportar propuesta", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/exportar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "exportar" ] }, "description": "Genera un ticket para exportar la propuesta de compras. El archivo estará disponible en Base64 al consultar el ticket.\n\nCon el numTicket recibido, consulta el endpoint Descargar propuesta hasta que el archivo esté listo para descargar.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Inconsistencias por comprobante", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/inconsistencia-por-comprobante", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "inconsistencia-por-comprobante" ] }, "description": "Detalle al hacer clic en el punto rojo (Inc.) de un comprobante en la propuesta RCE. Usa el codCar del listado de comprobantes.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Inconsistencias del período", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/inconsistencias", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "inconsistencias" ] }, "description": "Lista paginada de comprobantes con inconsistencias SUNAT en el RCE. Equivale a la pestaña Inconsistencias del portal.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Preliminares registrados", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/preliminares", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "preliminares" ] }, "description": "Consulta si el período tiene un preliminar registrado. Úsalo para obtener el id necesario antes de revertir con Eliminar preliminar registrado.\n\nUsa el id y codTipoRegistro exactos de la respuesta al llamar Eliminar preliminar registrado.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Resumen de inconsistencias", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/resumen", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "resumen" ] }, "description": "Muestra el porcentaje de comprobantes con errores en la propuesta. Revísalo antes de aceptar para asegurarte de que la propuesta está limpia.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Resumen de comprobantes", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/{periodo}/resumen-comprobantes", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", ":periodo", "resumen-comprobantes" ] }, "description": "Desglose de la propuesta por tipo de comprobante (Facturas, Liquidaciones, NC, ND) con totales de base imponible, IGV y monto.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Periodos", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/periodos", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", "periodos" ] }, "description": "Lista los períodos tributarios de compras disponibles y su estado ante SUNAT.\n\nRequisito previo: Para usar SIRE debes configurar las credenciales SOL de tu empresa: Client ID, Client Secret, Usuario SOL y Clave SOL. Puedes hacerlo en la sección de datos de tu empresa. Sin estas credenciales el endpoint retornará un error de autenticación.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Descargar propuesta", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/compras/tickets/{numTicket}/descargar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "compras", "tickets", ":numTicket", "descargar" ] }, "description": "Descarga el archivo de la propuesta generado con Exportar propuesta. Consulta el estado hasta que el archivo en Base64 esté disponible.\n\nCuando expirado: true, vuelve a llamar GET /sire/compras/ {periodo} /exportar para obtener un nuevo numTicket.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Consultar conciliación", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/conciliaciones/{conciliacionId}", "host": [ "{{baseUrl}}" ], "path": [ "sire", "conciliaciones", ":conciliacionId" ] }, "description": "Consulta el estado de una conciliación SIRE iniciada previamente con POST /conciliar. Hacer polling cada 10-15 segundos hasta COMPLETADO o ERROR.\n\nEste endpoint sirve tanto para conciliaciones de ventas como de compras — el campo libro indica cuál es.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Aceptar propuesta", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/aceptar-propuesta", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "aceptar-propuesta" ] }, "description": "Acepta la propuesta de ventas de SUNAT tal cual y avanza el período a Preliminar Registrado.\n\n¡Atención! Esta acción se ejecuta directamente en SUNAT y mueve el período a Preliminar Registrado. Si necesitas revertirlo, usa el endpoint Eliminar preliminar registrado antes de que el período avance a un estado irreversible.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Comprobantes", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/comprobantes", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "comprobantes" ] }, "description": "Lista paginada de los comprobantes de ventas incluidos en la propuesta SUNAT para el período.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Iniciar conciliación", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/conciliar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "conciliar" ] }, "description": "Compara los comprobantes de ventas de SUNAT contra los registrados en Facturalo e identifica diferencias de estado y montos.\n\nNo requiere body. Retorna de inmediato un conciliacionId — úsalo en el endpoint Consultar conciliación para obtener el resultado cuando el proceso termine.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "PUT Eliminar preliminar", "request": { "method": "PUT", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/eliminar-preliminar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "eliminar-preliminar" ] }, "description": "Revierte el período de estado Preliminar a Propuesta.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "PUT Eliminar preliminar registrado", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/eliminar-preliminar-registrado", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "eliminar-preliminar-registrado" ] }, "description": "Deshace la acción de Aceptar propuesta y regresa el período al estado Propuesta.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"id\": \"6a31b0f6b15a15e430ea42b8\",\n \"codTipoRegistro\": \"3\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "GET Exportar propuesta", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/exportar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "exportar" ] }, "description": "Genera un ticket para exportar la propuesta de ventas. El archivo estará disponible en Base64 al consultar el ticket.\n\nCon el numTicket recibido, consulta el endpoint Descargar propuesta hasta que el archivo esté listo para descargar.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Inconsistencias por comprobante", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/inconsistencia-por-comprobante", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "inconsistencia-por-comprobante" ] }, "description": "Detalle al hacer clic en el punto rojo (Inc.) de un comprobante en la propuesta RVIE. Usa el codCar del listado de comprobantes.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Inconsistencias del período", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/inconsistencias", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "inconsistencias" ] }, "description": "Lista paginada de comprobantes con inconsistencias SUNAT en el RVIE. Si el período no tiene fase o no hay inconsistencias (código SUNAT 2001), responde lista vacía.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Preliminares registrados", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/preliminares", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "preliminares" ] }, "description": "Consulta si el período tiene un preliminar registrado. Úsalo para obtener el id necesario antes de revertir con Eliminar preliminar registrado.\n\nUsa el id y codTipoRegistro exactos de la respuesta al llamar Eliminar preliminar registrado.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Resumen de inconsistencias", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/resumen", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "resumen" ] }, "description": "Muestra el porcentaje de comprobantes con errores en la propuesta. Revísalo antes de aceptar para asegurarte de que la propuesta está limpia.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Resumen de comprobantes", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/{periodo}/resumen-comprobantes", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", ":periodo", "resumen-comprobantes" ] }, "description": "Desglose de la propuesta por tipo de comprobante (Facturas, Boletas, NC, ND) con totales de base imponible, IGV y monto.\n\nSolo aparecen los tipos de comprobante que tienen datos en ese período. Las Notas de Crédito tienen montos negativos.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Periodos", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/periodos", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", "periodos" ] }, "description": "Lista los períodos tributarios de ventas disponibles y su estado ante SUNAT.\n\nRequisito previo: Para usar SIRE debes configurar las credenciales SOL de tu empresa: Client ID, Client Secret, Usuario SOL y Clave SOL. Puedes hacerlo en la sección de datos de tu empresa. Sin estas credenciales el endpoint retornará un error de autenticación.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "GET Descargar propuesta", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sire/ventas/tickets/{numTicket}/descargar", "host": [ "{{baseUrl}}" ], "path": [ "sire", "ventas", "tickets", ":numTicket", "descargar" ] }, "description": "Descarga el archivo de la propuesta generado con Exportar propuesta. Consulta el estado hasta que el archivo en Base64 esté disponible.\n\nCuando expirado: true, vuelve a llamar GET /sire/ventas/ {periodo} /exportar para obtener un nuevo numTicket.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] } ] }, { "name": "webhooks", "item": [ { "name": "GET Listar webhooks enviados", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "webhooks" ] }, "description": "Retorna el historial de webhooks enviados. Filtra por estado o evento para encontrar envíos fallidos y reenviarlos.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] }, { "name": "POST Reenviar webhook fallido", "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/webhooks/{eventoId}/reenviar", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":eventoId", "reenviar" ] }, "description": "Reenvía el payload original de un webhook fallido. Solo acepta eventos con tipo `documento.webhook.fallido` o `documento.webhook.reintento`. Se reenvía el payload exacto guardado en base de datos.", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{bearerToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }, "response": [] } ] } ] }