Editar comprobante (antes del envío)
PUT /api/documents/{document_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Corrige una factura o boleta que aún no fue enviada a SUNAT (estado 01), con el mismo cuerpo que Emitir comprobante electrónico. Si el comprobante ya fue aceptado, corrígelo con Emitir nota de crédito o Emitir nota de débito.
Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403. Además necesitas ser quien emitió el comprobante o tener el permiso de editar comprobantes (ver reglas).
Formato de respuesta: estándar {success, data, message?} (registro único).
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
integer | Sí | Id interno del comprobante ({document_id}). |
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
(todo el cuerpo) |
object | Sí | El mismo cuerpo de Emitir comprobante electrónico (POST documents): reutiliza tu payload con los datos corregidos. |
codigo_tipo_documento |
string | Sí | Debe ser el del comprobante (01 factura o 03 boleta): el tipo no cambia. |
serie_documento / numero_documento |
string | No | Si los envías deben ser los del comprobante (o # en el número). La serie y el número no cambian. |
codigo_tipo_operacion |
string | Sí | Catálogo 51 (0101 venta interna...). |
fecha_de_emision |
string Y-m-d |
Sí | Puede corregirse, dentro del plazo de envío configurado. |
hora_de_emision |
string H:i:s |
No | Si no la envías se conserva la del comprobante. |
datos_del_cliente_o_receptor |
object | Sí | Cliente (se crea o actualiza por tipo y número de documento). |
totales |
object | Sí | Totales recalculados del comprobante. |
items |
array (mín. 1) | Sí | Todas las líneas que debe tener el comprobante (las anteriores se reemplazan). |
pagos |
array | Sí si el comprobante tiene cobros | Todos los cobros que debe tener. [] lo deja sin cobros. Si el comprobante tenía cobros y no envías pagos, responde 422 (para no borrarlos por omisión). |
cuotas |
array | No | Cuotas de una venta al crédito (codigo_condicion_de_pago: 02). Se reemplazan. |
Estado del comprobante (state_type_id) y qué se puede hacer:
| Estado | Significado | Editar | Nota de crédito / débito |
|---|---|---|---|
01 |
Registrado (aún no enviado a SUNAT) | Sí | No: corrígelo editándolo o envíalo primero |
03 |
Enviado, espera respuesta | No (409) |
No (409): espera la respuesta |
05 |
Aceptado | No (409): usa una nota |
Sí |
07 |
Observado | No (409): usa una nota |
No (409) |
09 |
Rechazado | No (409): emite un comprobante nuevo |
No (409) |
11 |
Anulado | No (409) |
No (409) |
13 |
Por anular | No (409) |
No (409) |
Reglas:
- Reemplazo completo, no edición parcial: cliente, líneas, totales, pagos y cuotas quedan exactamente como los envías.
PUTyPATCHhacen lo mismo. - Solo comprobantes en estado Registrado (
01), es decir, aún no enviados a SUNAT. Ver la tabla de estados. - Solo facturas y boletas: una nota de crédito o débito no se edita (
409). - Quién puede editar: quien emitió el comprobante, o un usuario con el permiso Editar comprobantes cuando la empresa tiene habilitada la opción Permitir editar comprobantes. Un vendedor solo ve sus comprobantes (los de otro vendedor dan
403). - Se conservan la serie, el número, el
external_id, el usuario que lo emitió, el establecimiento y el origen (nota de venta, pedido, cotización). - El stock se ajusta en el almacén del establecimiento del comprobante: las líneas anteriores se devuelven y las nuevas se descuentan.
- Los cobros se reemplazan sin duplicar la caja: los anteriores salen de la caja y los nuevos entran a la caja abierta de quien edita (
codigo_destino_pago: cash) o a la cuenta indicada. Si algún cobro anterior pertenece a una caja ya cerrada, responde409. - Se regeneran el XML firmado, el hash, el QR y el PDF. La edición no envía a SUNAT: el comprobante sigue en
01; envíalo con Enviar comprobante a SUNAT (documents/send) o deja que el envío automático lo procese.
Errores:
403si el comprobante es de otro vendedor o no tienes permiso para editarlo.404si el comprobante no existe.409si el estado no es01(elmessagedice qué hacer según el estado), si es una nota, si algún cobro anterior está en una caja cerrada o si falta el certificado digital.422{success: false, message}si el cuerpo no es válido: falta un campo, cambia el tipo, la serie o el número, faltanpagosen un comprobante con cobros, o los pagos superan el total sin efectivo para el vuelto.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
document_id |
ruta | sí | 1 |
Cuerpo
Content-Type: application/json
{
"serie_documento": "B001",
"numero_documento": "245",
"fecha_de_emision": "2026-11-07",
"hora_de_emision": "10:15:00",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento": "03",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento": "2026-11-07",
"codigo_condicion_de_pago": "01",
"datos_del_cliente_o_receptor": {
"codigo_tipo_documento_identidad": "1",
"numero_documento": "45678912",
"apellidos_y_nombres_o_razon_social": "MARIA LOPEZ RAMOS",
"codigo_pais": "PE",
"direccion": "-",
"correo_electronico": "",
"telefono": ""
},
"totales": {
"total_exportacion": 0,
"total_operaciones_gravadas": 33.9,
"total_operaciones_inafectas": 0,
"total_operaciones_exoneradas": 0,
"total_operaciones_gratuitas": 0,
"total_igv": 6.1,
"total_impuestos": 6.1,
"total_valor": 33.9,
"total_venta": 40
},
"items": [
{
"codigo_interno": "P001",
"descripcion": "GASEOSA 500 ML",
"unidad_de_medida": "NIU",
"cantidad": 4,
"valor_unitario": 8.474576,
"codigo_tipo_precio": "01",
"precio_unitario": 10,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 33.9,
"porcentaje_igv": 18,
"total_igv": 6.1,
"total_impuestos": 6.1,
"total_valor_item": 33.9,
"total_item": 40
}
],
"pagos": [
{
"codigo_metodo_pago": "01",
"codigo_destino_pago": "cash",
"referencia": null,
"monto": 40
}
],
"acciones": {
"formato_pdf": "a4"
}
}
Respuestas
200 — Editado
{
"success": true,
"data": {
"id": 1520,
"number": "B001-245",
"document_type_id": "03",
"state_type_id": "01",
"state_type_description": "Registrado",
"external_id": "9b1c6c1e-5e63-4d7c-9a51-7d3c2b1f0a11",
"filename": "20123456789-03-B001-245",
"hash": "nT2bm1u3kz0b4xQ9gS6v8Lr2pYc=",
"date_of_issue": "2026-11-07",
"currency_type_id": "PEN",
"total": 40.0,
"links": {
"xml": "https://empresa.dominio/downloads/document/xml/9b1c6c1e-5e63-4d7c-9a51-7d3c2b1f0a11",
"pdf": "https://empresa.dominio/downloads/document/pdf/9b1c6c1e-5e63-4d7c-9a51-7d3c2b1f0a11"
}
},
"message": "Comprobante actualizado."
}
403 — Sin permiso de edición
{
"success": false,
"message": "No tienes permiso para editar este comprobante: solo lo edita quien lo emitió o un usuario con el permiso para editar comprobantes (y la opción habilitada en la configuración de la empresa)."
}
403 — Registro de otro vendedor
{
"success": false,
"message": "No tienes permiso para acceder a este registro."
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
409 — Aceptado
{
"success": false,
"message": "El comprobante ya fue aceptado por SUNAT y no se puede editar: para corregirlo usa una nota de crédito o débito."
}
409 — Rechazado
{
"success": false,
"message": "Un comprobante rechazado por SUNAT no se puede editar: emite uno nuevo."
}
422 — Cambia el tipo
{
"success": false,
"message": "El tipo de comprobante no se puede cambiar al editar (es 03)."
}
422 — Faltan pagos
{
"success": false,
"message": "La edición reemplaza el comprobante completo: envía \"pagos\" con los cobros que debe tener (o \"pagos\": [] para dejarlo sin cobros)."
}
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.