Saltar al contenido
Facturador

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.