tefacturo

Comenzar

Sigue estos 4 pasos para emitir tu primer comprobante electrónico con tefacturo.

1

Obtén tus credenciales

Para utilizar la API necesitas tres datos proporcionados por Close2u:

RUC

Número de RUC de tu empresa

Email

Correo registrado en la plataforma

Clave

Contraseña de acceso a la API

Para pruebas, puedes crear una cuenta de pruebas en /registro.

Para producción, contacta a Close2u para recibir credenciales de producción.

2

Generar token

Realiza una petición POST al endpoint de login para obtener un token JWT.

POSThttps://jarvis.tefacturo.pe/tokenapi/secure/v2/login/token

Cuerpo de la petición:

Request Body
{
    "aplicacion": {
        "codigo": "1"
    },
    "clave": "{{CLAVE}}",
    "mail": "{{USUARIO}}",
    "ruc": {{RUC}}
}

La respuesta contiene un campo c2uToken que es un JWT válido por 8 horas. Usa este token en todas tus peticiones subsiguientes.

Para cuentas de prueba en este portal de docs, renueva el token como máximo cada 1 hora.

Ejemplo de respuesta:

Response 200 OK
{
    "c2uToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "fechaExpiracion": "2025-01-15T08:00:00.000+00:00",
    "ruc": "20123456789",
    "razonSocial": "MI EMPRESA S.A.C.",
    "estado": "ACTIVO"
}
3

Usa el token en tus peticiones

Incluye los siguientes headers en cada petición a la API.

Headers requeridos
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

Authorization

Bearer seguido del valor de c2uToken

Content-Type

Siempre application/json

4

Emite tu primer comprobante

Con el token activo, realiza un PUT al endpoint de factura. Reemplaza {ruc} con el RUC del emisor.

PUT/factura-api/invoice2u/integracion/factura/{ruc}
Ejemplo de solicitud de Factura
PUT https://jarvis.tefacturo.pe/factura-api/invoice2u/integracion/factura/{ruc}
Authorization: Bearer {token}
Content-Type: application/json

{
    "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
        },
        {
            "codigoProducto": "ABC124",
            "descripcion": "PRODUCTO GRAVADO B",
            "tipoAfectacion": "GRAVADO_OPERACION_ONEROSA",
            "unidadMedida": "UNIDAD_BIENES",
            "cantidad": "1",
            "valorVentaUnitarioItem": 200
        }
    ],
    "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"
    }
}

Estos son solo casos básicos. Consulta la documentación completa de Factura para ver todos los campos y casos disponibles. Para otros tipos de comprobante, consulta la referencia de la API.

IntroducciónAutenticación