Saltar al contenido
Facturador

Registrar comprobante emitido en otro servidor

POST /api/documents_server

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Registra un comprobante ya firmado en otro servidor (sincronización entre instalaciones): guarda el XML firmado y el PDF recibidos en base64, conserva el external_id, hash y QR de origen y, si query es true y es factura o nota de factura, lo envía a SUNAT.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

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: true}.

Acepta el mismo cuerpo que Emitir comprobante electrónico (ver sus tablas) más estos campos:

Campo Tipo Obligatorio Descripción / valores permitidos
external_id string (uuid) Sí external_id del comprobante en el servidor de origen.
hash string Sí Hash (DigestValue) del XML firmado.
qr string Sí Imagen QR en base64.
file_xml_signed string (base64) Sí XML firmado.
file_pdf string (base64) Sí PDF.
query boolean Sí true para enviarlo a SUNAT al registrarlo (solo facturas y sus notas).

La serie y el número deben ser los del comprobante original (no uses #).

Errores:

  • 400 {success: false, message}: el cuerpo no superó la validación previa (serie inexistente para el tipo de documento o el establecimiento, código de establecimiento incorrecto, ubigeo inválido, documento de identidad del cliente no permitido para el tipo de comprobante, fecha fuera de plazo, comprobante afectado inexistente, etc.).
  • 500 {success: false, message}: error al firmar o al comunicarse con SUNAT/OSE, o un dato que el servidor no pudo procesar.
  • 401 sin token.

Cuerpo

Content-Type: application/json

{
  "serie_documento": "F001",
  "numero_documento": 1520,
  "fecha_de_emision": "2026-11-07",
  "hora_de_emision": "10:11:11",
  "codigo_tipo_operacion": "0101",
  "codigo_tipo_documento": "01",
  "codigo_tipo_moneda": "PEN",
  "factor_tipo_de_cambio": 1,
  "fecha_de_vencimiento": "2026-11-07",
  "numero_orden_de_compra": "OC-2026-0045",
  "numero_de_placa": null,
  "folio": null,
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "20501973522",
    "apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.C.",
    "nombre_comercial": "XYZ",
    "codigo_pais": "PE",
    "ubigeo": "150101",
    "direccion": "Av. 2 de Mayo 123, Lima",
    "correo_electronico": "facturacion@xyz.com.pe",
    "telefono": "014271148",
    "codigo_tipo_direccion": null
  },
  "totales": {
    "total_anticipos": 0,
    "total_descuentos": 0,
    "total_cargos": 0,
    "total_exportacion": 0,
    "total_operaciones_gravadas": 100.0,
    "total_operaciones_inafectas": 0,
    "total_operaciones_exoneradas": 0,
    "total_operaciones_gratuitas": 0,
    "total_igv_operaciones_gratuitas": 0,
    "total_igv": 18.0,
    "total_base_isc": 0,
    "total_isc": 0,
    "total_base_otros_impuestos": 0,
    "total_otros_impuestos": 0,
    "total_impuestos_bolsa_plastica": 0,
    "total_impuestos": 18.0,
    "total_valor": 100.0,
    "subtotal_venta": 118.0,
    "total_venta": 118.0,
    "total_pendiente_pago": 0
  },
  "items": [
    {
      "codigo_interno": "P0121",
      "descripcion": "GASEOSA 500ML",
      "nombre": null,
      "nombre_secundario": null,
      "codigo_tipo_item": "01",
      "codigo_producto_sunat": "50202306",
      "codigo_producto_gsl": null,
      "unidad_de_medida": "NIU",
      "cantidad": 2,
      "valor_unitario": 50,
      "codigo_tipo_precio": "01",
      "precio_unitario": 59,
      "codigo_tipo_afectacion_igv": "10",
      "total_base_igv": 100.0,
      "porcentaje_igv": 18,
      "total_igv": 18.0,
      "codigo_tipo_sistema_isc": null,
      "total_base_isc": 0,
      "porcentaje_isc": 0,
      "total_isc": 0,
      "total_base_otros_impuestos": 0,
      "porcentaje_otros_impuestos": 0,
      "total_otros_impuestos": 0,
      "total_impuestos_bolsa_plastica": 0,
      "total_impuestos": 18.0,
      "total_valor_item": 100.0,
      "total_cargos": 0,
      "total_descuentos": 0,
      "total_item": 118.0,
      "datos_adicionales": [],
      "descuentos": [],
      "cargos": [],
      "informacion_adicional": null,
      "lots": [],
      "actualizar_descripcion": false,
      "nombre_producto_pdf": null,
      "nombre_producto_xml": null,
      "dato_adicional": null
    }
  ],
  "descuentos": [],
  "cargos": [],
  "pagos": [
    {
      "codigo_metodo_pago": "01",
      "codigo_destino_pago": "cash",
      "referencia": "",
      "monto": 118.0,
      "pago_recibido": 120.0
    }
  ],
  "cuotas": [],
  "codigo_condicion_de_pago": "01",
  "anticipos": [],
  "guias": [],
  "relacionados": [],
  "leyendas": [],
  "informacion_adicional": "Entrega en almacén del cliente",
  "dato_adicional": null,
  "terminos_condiciones": null,
  "codigo_vendedor": null,
  "codigo_nota_venta": null,
  "pago_anticipado": false,
  "es_itinerante": false,
  "acciones": {
    "enviar_email": false,
    "enviar_xml_firmado": true,
    "formato_pdf": "a4",
    "auto_print": false,
    "name_printer": null,
    "client_public_ip": null
  },
  "external_id": "9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
  "hash": "kJ8xQ2m0pZ3l7m9aB1c2d3e4f5g=",
  "qr": "iVBORw0KGgoAAAANSUhEUgAA...",
  "file_xml_signed": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4...",
  "file_pdf": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK...",
  "query": true
}

Respuestas

200 — Registrado

{
  "success": true
}

400 — Serie incorrecta

{
  "success": false,
  "message": "La serie ingresada F001, 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.