Factura sujeta a retención
/comprobantes/emitirscope: invoices.createdocumento.retencion.tipo marca la factura como sujeta al Régimen de Retenciones del IGV — no cambia sunatTransaccion (se queda en "0101", venta interna gravada) ni afecta los totales del comprobante.
Parámetros del body
webhookSi es true, la respuesta es inmediata (EN_PROCESO) y el resultado llega a tu webhook configurado. Si es false (por defecto), la llamada espera la respuesta de SUNAT antes de responder.
documentoDatos del comprobante electrónico.
sunatTransaccionCódigo de tipo de operación SUNAT. Gravada: "0101" — ver la variante correspondiente para otros códigos.
tipoComprobante01 = factura, 03 = boleta.
serieSerie del comprobante. Facturas: F001–F999. Boletas: B001–B999.
monedaCódigo de moneda.
formaPagoCondición de pago.
fechaEmisionFecha de emisión.
fechaVencimientoRequerido si formaPago es CREDITO — fecha de la última cuota.
clienteDatos del cliente.
tipoDocumentoCatálogo SUNAT 06 (ej. "1" = DNI, "6" = RUC).
numeroDocumentoNúmero de documento del cliente.
denominacionNombre o razón social del cliente.
direccionDirección fiscal del cliente.
correoCorreo del cliente — Facto le reenvía el comprobante (opcional).
itemsÍtems del comprobante.
descripcionDescripción del ítem.
unidadMedidaUnidad de medida SUNAT (ej. NIU, ZZ).
cantidadCantidad.
precioUnitarioPrecio unitario, IGV incluido.
tipoIgvCódigo de afectación IGV — ver la tabla en Conceptos.
cuotasRequerido si formaPago es CREDITO — cronograma de pago. Facto asigna el número de cuota en la respuesta.
montoMonto de la cuota.
fechaVencimientoFecha de vencimiento de la cuota.
retencionMarca el comprobante como sujeto al Régimen de Retenciones del IGV. Es puramente informativo para la conciliación interna del tenant — no genera un nodo distinto en el XML enviado a SUNAT ni cambia sunatTransaccion.
tipoCatálogo 22 SUNAT. "01" = tasa 3% (régimen general), "02" = tasa 6% (venta interna de oro).
La factura se emite por su monto íntegro (en el ejemplo, 2000 + 360 de IGV = 2360) — el régimen de retenciones no descuenta nada del comprobante en sí. Es el cliente (el agente retenedor) quien, al pagar, retiene un porcentaje del total según el tipo del catálogo 22 de SUNAT: "01" = tasa 3% (régimen general), "02" = tasa 6% (venta interna de oro). Ver la referencia completa de campos.
documento.retencion no aparece en la respuesta
documento de la respuesta no trae de vuelta retencion. Es información puramente interna: no genera ningún nodo distinto en el XML que se envía a SUNAT ni cambia sunatTransaccion — solo queda registrada en Facto para la conciliación del propio tenant.Facto no emite el Comprobante de Retención
cliente.denominacion vuelve vacío en la respuesta
documento.cliente.denominacion, la respuesta ACEPTADA la trae vacía ("") — no es un error de este ejemplo en particular, es el valor que devuelve la API hoy.