Emitir liquidación de compra
POST /api/purchase-settlements
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Emite una liquidación de compra (04): el comprobante que la empresa emite al comprar a personas naturales sin RUC (productores, recolectores, etc.). Lo firma, genera el PDF, lo envía por correo si se pide y a SUNAT.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Se emite en el establecimiento del usuario del token.
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. Respuesta {success, data: {number, filename, external_id, number_to_letter, hash}, links: {xml, pdf, cdr}, response}.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
serie_documento |
string | Sí | Serie de liquidación (L001). |
numero_documento |
string / integer | Sí | Correlativo. Envía "#" para que la plataforma asigne el siguiente número de la serie (recomendado). |
fecha_de_emision / hora_de_emision |
date / string | Sí | YYYY-MM-DD / HH:MM:SS. |
codigo_tipo_operacion |
string | Sí | Catálogo SUNAT 51 (0501 compra interna). |
codigo_tipo_documento |
string | Sí | 04. |
codigo_tipo_moneda / factor_tipo_de_cambio |
string / numeric | Sí / No | PEN/USD; tipo de cambio (por defecto 1). |
datos_del_proveedor_o_receptor |
object | Sí | Vendedor (persona natural, normalmente DNI 1): mismas claves que el cliente de un comprobante. |
datos_de_la_operacion |
object | Sí | Lugar de la operación: {codigo_pais, ubigeo, direccion, codigo_tipo_direccion}. |
totales |
object | Sí | total_anticipos, total_operaciones_gravadas, total_operaciones_inafectas, total_operaciones_exoneradas, total_igv, total_impuestos, total_valor, subtotal_compra, total_compra. |
items |
array | Sí | Líneas: codigo_interno, descripcion, unidad_de_medida (obligatorios), codigo_tipo_item, codigo_producto_sunat, codigo_producto_gsl, cantidad, valor_unitario, codigo_tipo_precio, precio_unitario, codigo_tipo_afectacion_igv, total_base_igv, porcentaje_igv, total_igv, total_impuestos, total_valor_item, total_item y, si hay retención del impuesto a la renta, codigo_tipo_afectacion_igv_impuesto_renta, porcentaje_retencion_renta, monto_retencion_renta. |
anticipos / relacionados |
array | No | [{numero, codigo_tipo_documento, monto}]. |
leyendas |
array | No | [{codigo, valor}]. |
observaciones |
string | No | Observaciones. |
acciones |
object | No | {enviar_email, enviar_xml_firmado, formato_pdf}. |
Reglas: usa productos ya registrados (codigo_interno existente); un código nuevo puede ser rechazado. Si no se envió a SUNAT, links.cdr llega "" y response como [].
Errores: 400 {success: false, message} si la serie, el establecimiento o un dato no supera la validación previa (La serie ingresada R001, es incorrecta., El código ingresado del establecimiento es incorrecto.); 500 ante errores de SUNAT.
codigo_tipo_direccion (catálogo de tipos de dirección): 01 punto de venta, 02 producción, 03 extracción, 04 explotación, 05 otros. Un código que no exista responde 400.
Cuerpo
Content-Type: application/json
{
"serie_documento": "L001",
"numero_documento": "#",
"fecha_de_emision": "2026-11-07",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0501",
"codigo_tipo_documento": "04",
"codigo_tipo_moneda": "PEN",
"factor_tipo_de_cambio": 1,
"datos_del_proveedor_o_receptor": {
"codigo_tipo_documento_identidad": "1",
"numero_documento": "45678912",
"apellidos_y_nombres_o_razon_social": "JUAN PEREZ QUISPE",
"nombre_comercial": null,
"codigo_pais": "PE",
"ubigeo": "120101",
"direccion": "Jr. Los Andes 123, Huancayo",
"correo_electronico": null,
"telefono": null,
"codigo_tipo_direccion": null
},
"datos_de_la_operacion": {
"codigo_pais": "PE",
"ubigeo": "120101",
"direccion": "Jr. Los Andes 123, Huancayo",
"codigo_tipo_direccion": "01"
},
"totales": {
"total_anticipos": 0,
"total_operaciones_gravadas": 0,
"total_operaciones_inafectas": 0,
"total_operaciones_exoneradas": 100.0,
"total_igv": 0,
"total_impuestos": 0,
"total_valor": 100.0,
"subtotal_compra": 100.0,
"total_compra": 100.0
},
"items": [
{
"codigo_interno": "MP001",
"descripcion": "PAPA AMARILLA X KG",
"codigo_tipo_item": "01",
"codigo_producto_sunat": "50404100",
"codigo_producto_gsl": null,
"unidad_de_medida": "KGM",
"cantidad": 50,
"valor_unitario": 2,
"codigo_tipo_precio": "01",
"precio_unitario": 2,
"codigo_tipo_afectacion_igv": "20",
"total_base_igv": 100.0,
"porcentaje_igv": 18,
"total_igv": 0,
"total_impuestos": 0,
"total_valor_item": 100.0,
"total_item": 100.0,
"codigo_tipo_afectacion_igv_impuesto_renta": null,
"porcentaje_retencion_renta": null,
"monto_retencion_renta": null
}
],
"anticipos": [],
"relacionados": [],
"leyendas": [],
"observaciones": "",
"acciones": {
"enviar_email": false,
"enviar_xml_firmado": true,
"formato_pdf": "a4"
}
}
Respuestas
200 — Emitida
{
"success": true,
"data": {
"number": "L001-8",
"filename": "20123456789-04-L001-8",
"external_id": "c4b7e2a1-6d3f-4e8a-9b10-5f4e3d2c1b0a",
"number_to_letter": "CIEN CON 00/100",
"hash": "Qm9xY2FzaGhhc2gxMjM0NTY3OA="
},
"links": {
"xml": "https://empresa.dominio/downloads/purchaseSettlement/xml/c4b7e2a1-6d3f-4e8a-9b10-5f4e3d2c1b0a",
"pdf": "https://empresa.dominio/downloads/purchaseSettlement/pdf/c4b7e2a1-6d3f-4e8a-9b10-5f4e3d2c1b0a",
"cdr": "https://empresa.dominio/downloads/purchaseSettlement/cdr/c4b7e2a1-6d3f-4e8a-9b10-5f4e3d2c1b0a"
},
"response": {
"code": "0",
"description": "La Liquidacion de compra numero L001-8, ha sido aceptada",
"notes": []
}
}
400 — Serie
{
"success": false,
"message": "La serie ingresada L009, es incorrecta."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.