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

Reglas de uso importantes

tipoIntegracion: OFFLINE → tu propio ERP se encarga del correlativo (serie/número). ERP → tefacturo se encarga del correlativo.
numero (en datosDocumento): no puede estar duplicado. Si el número ya fue utilizado, mapea/controla el correlativo para no reenviarlo.
fechaEmision: un comprobante (CPE) se puede declarar con un máximo de 3 días de anterioridad.
Reemplaza el RUC fijo del ejemplo por el RUC emisor usado en la URL y el token; los tres deben coincidir.
Los valores de la respuesta 200, como serie, número, hash, firma e identificador, son ilustrativos; el API genera sus valores reales en cada solicitud.

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

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 gravada, factura crédito, 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 los datos generados del comprobante: firma, hash, identificador, serie, número, total, observación y tipo_documento. 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 cómo 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.

Nota técnica de cálculo IGV

Usa el campo unitario según la afectación IGV del ítem y close2u.tipoRegistro. El sistema completa el valor de venta o precio de venta complementario cuando puede derivarlo por la regla de IGV.

Caso	Campo a enviar	Interpretación del sistema
Gravado + PRECIOS_SIN_IGV	valorVentaUnitarioItem	Valor de venta sin IGV. El sistema calcula el IGV y obtiene el precio de venta.
Gravado + PRECIOS_CON_IGV	precioVentaUnitarioItem	Precio de venta con IGV. El sistema lo descompone para reemplazar/obtener el valor de venta y el impuesto.
Exonerado o inafecto	valorVentaUnitarioItem	No hay IGV por calcular. En ausencia de IGV, el sistema asume el valor enviado como base y lo usa como precio de venta.

Referencia de Campos

Tabla completa de los campos del cuerpo de la solicitud:

Objeto close2u3 campos

Campo	Tipo	Requerido	Descripción
tipoIntegracion	string	Sí	Tipo de integración. Usar "OFFLINE"
tipoPlantilla	string	Sí	Plantilla del PDF. "01" es la plantilla estándar
tipoRegistro	string	Sí	PRECIOS_CON_IGV o PRECIOS_SIN_IGV

Objeto datosDocumentocampos principales

Campo	Tipo	Requerido	Descripción
serie	string	Sí	Serie del comprobante (ej: FFA6). Debe iniciar con "F" para facturas
numero	number	Sí	Número correlativo del comprobante
moneda	string	Sí	Código de moneda ISO 4217. PEN (soles), USD (dólares)
fechaEmision	string	Sí	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	Sí	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

Objeto detalleDocumentoarray (items)

Campo	Tipo	Requerido	Descripción
codigoProducto	string	Sí	Código interno del producto o servicio
descripcion	string	Sí	Descripción detallada del producto o servicio
tipoAfectacion	string	Sí	Tipo de afectación IGV: GRAVADO_OPERACION_ONEROSA, EXONERADO_OPERACION_ONEROSA, INAFECTO_OPERACION_ONEROSA
unidadMedida	string	Sí	Unidad de medida: UNIDAD_BIENES, KILOGRAMO, SERVICIO, etc.
cantidad	string	Sí	Cantidad de unidades del producto
valorVentaUnitarioItem	number	Sí	Precio unitario. Depende del tipoRegistro (con o sin IGV)

Objeto emisordatos del emisor

Campo	Tipo	Requerido	Descripción
correo	string	Sí	Correo electrónico del emisor
nombreComercial	string	Sí	Nombre comercial de la empresa emisora
nombreLegal	string	Sí	Razón social registrada en SUNAT
numeroDocumentoIdentidad	string	Sí	RUC del emisor (11 dígitos)
tipoDocumentoIdentidad	string	Sí	Tipo de documento: RUC

Objeto receptorcliente

Campo	Tipo	Requerido	Descripción
correo	string	Sí	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	Sí	Nombre comercial del cliente
nombreLegal	string	Sí	Razón social del cliente
numeroDocumentoIdentidad	string	Sí	RUC o DNI del cliente
tipoDocumentoIdentidad	string	Sí	RUC, DNI, CE (carnet de extranjería), PASAPORTE

Objeto informacionAdicionalopcional

Campo	Tipo	Requerido	Descripción
tipoOperacion	string	Sí	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.

Endpoints Relacionados

PUTEmitir Boleta PUTEmitir Nota de Crédito PUTConsultar PDF PUTVista Previa

EJEMPLOS

Request Body

{
  "close2u": {
    "tipoIntegracion": "OFFLINE",
    "tipoPlantilla": "01",
    "tipoRegistro": "PRECIOS_SIN_IGV"
  },
  "datosDocumento": {
    "serie": "FFA6",
    "numero": 1,
    "moneda": "PEN",
    "fechaEmision": "2025-04-16",
    "horaEmision": null,
    "formaPago": "CONTADO",
    "medioPago": "DEPOSITO_CUENTA",
    "condicionPago": "CONTADO",
    "ordencompra": null,
    "glosa": "observaciones"
  },
  "detalleDocumento": [
    {
      "codigoProducto": "ABC123",
      "descripcion": "PRODUCTO GRAVADO A",
      "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
      "unidadMedida": "UNIDAD_BIENES",
      "cantidad": "1",
      "valorVentaUnitarioItem": 100
    }
  ],
  "emisor": {
    "correo": "pruebasintegraciontest@gmail.com",
    "nombreComercial": "ALFA PLUS SAC",
    "nombreLegal": "ALFA PLUS S.A.C.",
    "numeroDocumentoIdentidad": "20133795724",
    "tipoDocumentoIdentidad": "RUC"
  },
  "informacionAdicional": {
    "tipoOperacion": "VENTA_INTERNA",
    "coVendedor": "AARROYO"
  },
  "receptor": {
    "correo": "pruebatest@gmail.com",
    "correoCopia": "andreatest768@gmail.com",
    "domicilioFiscal": {
      "direccion": "AV. PTE PIEDRA NRO. 386 - PRO - LIMA LIMA PUENTE PIEDRA",
      "ubigeo": "150101"
    },
    "nombreComercial": "AIR SERVICE PUCALLPA TOURS",
    "nombreLegal": "AIR SERVICE PUCALLPA TOURS E.I.R.L.",
    "numeroDocumentoIdentidad": "20393663988",
    "tipoDocumentoIdentidad": "RUC"
  }
}

Response 200

{
  "codigobBarras": null,
  "firma": "[B@59463eb5",
  "hash": "sq9YJ1FdRCGjvjWz1gGvW9eWiaA=",
  "identificador": "3687658869748478001",
  "numero": 248,
  "serie": "FFA3",
  "total": 23.6,
  "observacion": null,
  "tipo_documento": "Factura"
}