Emitir Factura Electrónica
Servicio para emitir facturas electrónicas validadas por SUNAT. La factura es el comprobante de pago utilizado en transacciones entre empresas (B2B).
https://jarvis.tefacturo.pe/factura-api/invoice2u/integracion/factura/{ruc}Servicio para emitir facturas electrónicas. Reemplaza {ruc} con el RUC del emisor. El comprobante será firmado digitalmente y enviado a SUNAT de forma automática.
Headers
| Header | Valor | Descripción |
|---|---|---|
| Authorization | Bearer {token} | Token de autenticación obtenido del endpoint de login |
| Content-Type | application/json | Tipo de contenido del cuerpo de la solicitud |
Cuerpo de la Solicitud
Envía el payload completo del comprobante. El panel derecho usa los mismos casos de la página de Ejemplos JSON: factura base, factura crédito, factura gravada, factura exonerada y factura gratuita.
Respuesta Exitosa (200)
Cuando la factura es emitida correctamente, la API retorna la serie y el número correlativo del comprobante generado. Esto confirma que la factura fue firmada digitalmente, enviada a SUNAT y aceptada satisfactoriamente.
Tipo de Registro de Precios
El campo tipoRegistro dentro del objeto close2u define como se interpretan los precios enviados en el detalle del documento:
| Valor | Descripción |
|---|---|
| PRECIOS_SIN_IGV | Los precios enviados en valorVentaUnitarioItem NO incluyen IGV. El sistema calculará el IGV (18%) automáticamente sobre el valor enviado. |
| PRECIOS_CON_IGV | Los precios enviados YA incluyen IGV. El sistema descompondrá el precio para obtener la base imponible y el impuesto correspondiente. |
Referencia de Campos
Tabla completa de los campos del cuerpo de la solicitud:
close2u| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| tipoIntegracion | string | Si | Tipo de integración. Usar "OFFLINE" |
| tipoPlantilla | string | Si | Plantilla del PDF. "01" es la plantilla estandar |
| tipoRegistro | string | Si | PRECIOS_CON_IGV o PRECIOS_SIN_IGV |
datosDocumento| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| serie | string | Si | Serie del comprobante (ej: FFA6). Debe iniciar con "F" para facturas |
| numero | number | Si | Número correlativo del comprobante |
| moneda | string | Si | Código de moneda ISO 4217. PEN (soles), USD (dólares) |
| fechaEmision | string | Si | Fecha de emisión en formato YYYY-MM-DD |
| horaEmision | string | null | No | Hora de emisión en formato HH:mm:ss. Si es null, se usa la hora actual |
| formaPago | string | Si | CONTADO o CREDITO |
| medioPago | string | No | Medio de pago: DEPOSITO_CUENTA, TRANSFERENCIA, EFECTIVO, etc. |
| condicionPago | string | No | Condicion de pago: CONTADO, CREDITO_30, CREDITO_60, etc. |
| ordencompra | string | null | No | Número de orden de compra asociada |
| glosa | string | No | Observaciones o notas adicionales del comprobante |
detalleDocumento| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| codigoProducto | string | Si | Código interno del producto o servicio |
| descripcion | string | Si | Descripción detallada del producto o servicio |
| tipoAfectacion | string | Si | Tipo de afectación IGV: GRAVADO_OPERACION_ONEROSA, EXONERADO_OPERACION_ONEROSA, INAFECTO_OPERACION_ONEROSA |
| unidadMedida | string | Si | Unidad de medida: UNIDAD_BIENES, KILOGRAMO, SERVICIO, etc. |
| cantidad | string | Si | Cantidad de unidades del producto |
| valorVentaUnitarioItem | number | Si | Precio unitario. Depende del tipoRegistro (con o sin IGV) |
emisor| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| correo | string | Si | Correo electrónico del emisor |
| nombreComercial | string | Si | Nombre comercial de la empresa emisora |
| nombreLegal | string | Si | Razón social registrada en SUNAT |
| numeroDocumentoIdentidad | string | Si | RUC del emisor (11 dígitos) |
| tipoDocumentoIdentidad | string | Si | Tipo de documento: RUC |
receptor| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| correo | string | Si | Correo electrónico del cliente |
| correoCopia | string | No | Correo adicional para copia del comprobante |
| domicilioFiscal.direccion | string | No | Dirección fiscal del cliente |
| domicilioFiscal.ubigeo | string | No | Código de ubigeo INEI (6 dígitos) |
| nombreComercial | string | Si | Nombre comercial del cliente |
| nombreLegal | string | Si | Razón social del cliente |
| numeroDocumentoIdentidad | string | Si | RUC o DNI del cliente |
| tipoDocumentoIdentidad | string | Si | RUC, DNI, CE (carnet de extranjería), PASAPORTE |
informacionAdicional| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| tipoOperacion | string | Si | Tipo de operación SUNAT: VENTA_INTERNA, EXPORTACION, etc. |
| coVendedor | string | No | Código del vendedor asignado al comprobante |
Manejo de Errores
| Código | Estado | Descripción |
|---|---|---|
| 400 | Bad Request | El cuerpo de la solicitud contiene errores de validación. Verifique los campos requeridos y sus formatos. |
| 401 | Unauthorized | Token de autenticación inválido, expirado o no proporcionado. |
| 403 | Forbidden | No tiene permisos para emitir comprobantes con el RUC indicado. |
| 404 | Not Found | El RUC proporcionado no está registrado en el sistema. |
| 500 | Internal Server Error | Error interno del servidor. Intente nuevamente o contacte soporte. |
