Saltar al contenido
Facturador

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. PUT y PATCH hacen 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, responde 409.
  • 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:

  • 403 si el comprobante es de otro vendedor o no tienes permiso para editarlo.
  • 404 si el comprobante no existe.
  • 409 si el estado no es 01 (el message dice 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, faltan pagos en un comprobante con cobros, o los pagos superan el total sin efectivo para el vuelto.
  • 401 sin 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.