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.401sin 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.