/comprobantes/emitirscope: invoices.createFactura sujeta a retención
documento.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 llamada responde de inmediato (HTTP 202) con el comprobante en estado "pendiente_envio" y el resultado final llega a tu webhook configurado. Si es false (por defecto), la llamada espera la respuesta de SUNAT y devuelve el comprobante completo 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: "6" RUC, "1" DNI, "4" carné de extranjería, "7" pasaporte, "B" no domiciliado. Una factura exige RUC ("6"), salvo exportación con "B". En una boleta hasta S/ 700 puede omitirse junto con el número: se emite a cliente varios (DNI 00000000).
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. "17" (IVAP) no está soportado.
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.