/comprobantes/emitirscope: invoices.createFactura con detracción
El objeto documento.detraccion fuerza automáticamente sunatTransaccion a "1001".
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.
detraccionPresente solo si la operación está sujeta a detracción (SPOT) — fuerza sunatTransaccion a "1001".
codigoCódigo del bien/servicio sujeto a detracción (Anexo 3 SPOT).
medioPagoMedio de pago de la detracción.
cuentaBancariaCuenta de detracción del Banco de la Nación.
El porcentaje y el monto de la detracción se calculan en el servidor a partir del codigo — no los envías. Ver la referencia completa de campos.
Además de los datos del SPOT (cuenta del Banco de la Nación, código, porcentaje y monto), el XML lleva la leyenda 2006 ("Operación sujeta a detracción") y el PDF —A4 y tickets— muestra un bloque con esos datos: el comprador los necesita para hacer el depósito.
La detracción también puede aplicar a una boleta: depende del bien o servicio, no del tipo de comprobante.