teFacturo

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).

PUThttps://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

HeaderValorDescripción
AuthorizationBearer {token}Token de autenticación obtenido del endpoint de login
Content-Typeapplication/jsonTipo 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.

Los ejemplos completos están en el panel derecho para copiar rápidamente.

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.

Revisa el panel derecho para ver y copiar la respuesta de ejemplo.

Tipo de Registro de Precios

El campo tipoRegistro dentro del objeto close2u define como se interpretan los precios enviados en el detalle del documento:

ValorDescripción
PRECIOS_SIN_IGVLos precios enviados en valorVentaUnitarioItem NO incluyen IGV. El sistema calculará el IGV (18%) automáticamente sobre el valor enviado.
PRECIOS_CON_IGVLos 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:

Objeto close2u3 campos
CampoTipoRequeridoDescripción
tipoIntegracionstringSiTipo de integración. Usar "OFFLINE"
tipoPlantillastringSiPlantilla del PDF. "01" es la plantilla estandar
tipoRegistrostringSiPRECIOS_CON_IGV o PRECIOS_SIN_IGV
Objeto datosDocumentocampos principales
CampoTipoRequeridoDescripción
seriestringSiSerie del comprobante (ej: FFA6). Debe iniciar con "F" para facturas
numeronumberSiNúmero correlativo del comprobante
monedastringSiCódigo de moneda ISO 4217. PEN (soles), USD (dólares)
fechaEmisionstringSiFecha de emisión en formato YYYY-MM-DD
horaEmisionstring | nullNoHora de emisión en formato HH:mm:ss. Si es null, se usa la hora actual
formaPagostringSiCONTADO o CREDITO
medioPagostringNoMedio de pago: DEPOSITO_CUENTA, TRANSFERENCIA, EFECTIVO, etc.
condicionPagostringNoCondicion de pago: CONTADO, CREDITO_30, CREDITO_60, etc.
ordencomprastring | nullNoNúmero de orden de compra asociada
glosastringNoObservaciones o notas adicionales del comprobante
Objeto detalleDocumentoarray (items)
CampoTipoRequeridoDescripción
codigoProductostringSiCódigo interno del producto o servicio
descripcionstringSiDescripción detallada del producto o servicio
tipoAfectacionstringSiTipo de afectación IGV: GRAVADO_OPERACION_ONEROSA, EXONERADO_OPERACION_ONEROSA, INAFECTO_OPERACION_ONEROSA
unidadMedidastringSiUnidad de medida: UNIDAD_BIENES, KILOGRAMO, SERVICIO, etc.
cantidadstringSiCantidad de unidades del producto
valorVentaUnitarioItemnumberSiPrecio unitario. Depende del tipoRegistro (con o sin IGV)
Objeto emisordatos del emisor
CampoTipoRequeridoDescripción
correostringSiCorreo electrónico del emisor
nombreComercialstringSiNombre comercial de la empresa emisora
nombreLegalstringSiRazón social registrada en SUNAT
numeroDocumentoIdentidadstringSiRUC del emisor (11 dígitos)
tipoDocumentoIdentidadstringSiTipo de documento: RUC
Objeto receptorcliente
CampoTipoRequeridoDescripción
correostringSiCorreo electrónico del cliente
correoCopiastringNoCorreo adicional para copia del comprobante
domicilioFiscal.direccionstringNoDirección fiscal del cliente
domicilioFiscal.ubigeostringNoCódigo de ubigeo INEI (6 dígitos)
nombreComercialstringSiNombre comercial del cliente
nombreLegalstringSiRazón social del cliente
numeroDocumentoIdentidadstringSiRUC o DNI del cliente
tipoDocumentoIdentidadstringSiRUC, DNI, CE (carnet de extranjería), PASAPORTE
Objeto informacionAdicionalopcional
CampoTipoRequeridoDescripción
tipoOperacionstringSiTipo de operación SUNAT: VENTA_INTERNA, EXPORTACION, etc.
coVendedorstringNoCódigo del vendedor asignado al comprobante

Manejo de Errores

CódigoEstadoDescripción
400Bad RequestEl cuerpo de la solicitud contiene errores de validación. Verifique los campos requeridos y sus formatos.
401UnauthorizedToken de autenticación inválido, expirado o no proporcionado.
403ForbiddenNo tiene permisos para emitir comprobantes con el RUC indicado.
404Not FoundEl RUC proporcionado no está registrado en el sistema.
500Internal Server ErrorError interno del servidor. Intente nuevamente o contacte soporte.

Endpoints Relacionados