Autenticación

Para poder realizar emisiones o consultas de comprobantes en el API de Factura Online es necesario autenticar cada request con un token.

Obtener Token

Con las credenciales de acceso suministradas deberá hacer una petición a la siguiente ruta:

URL

{warning} Tenga cuidado con la privacidad de sus credenciales ya que brindan acceso completo a su cuenta.

METHOD PATH HEADERS
POST /api/login Content-Type:application/json

Parámetros

NAME TYPE DESCRIPTION CONDITION
ruc STRING RUC de la empresa required
usuario STRING Usuario suministrado en el correo de bienvenida required
clave STRING Clave suministrada en el correo de bienvenida required

Ejemplo

{
    "ruc":"88888888888",
    "usuario":"Usuario",
    "clave":"Contraseña"
}

Solicitud exitosa

{success} Solicitud Aceptada

HTTP_CODE 200

Contenido

{
    "response": {
        "error": 140,
        "msg": "Login Exitoso"
    },
    "authorization": {
        "idUsuario": integer,
        "accessKey": "string|hash",
        "descripcion": "string",
        "rol": "string",
        "emisor": {
            "idEmisor": "string",
            "razonSocial": "string",
            "condicion": "string",
            "estado": "ACTIVO|INACTIVO",
            "configuracion": {
                "emiteBoleta": boolean,
                "emiteFactura": boolean,
                "emiteRetencion": "string",
                "enviaCorreo": boolean,
                "tipoCodigoBarra": "string"
            },
            "domicilio": {
                "domicilioFiscal": "string",
                "idDomicilio": integer,
                "departamento": "string",
                "provincia": "string",
                "distrito": "string",
                "direccion": "string",
                "ubigeo": "string",
                "urbanizacion": "string",
                "idEmisor": "string"
            }
        }
    },
    "user": {
        "username": "string"
    },
    "token": "string",
    "expire": "datetime"
}

Solicitud no exitosa

{danger} Solicitud no aceptada

HTTP_CODE 40X

Contenido

{
    "error": integer,
    "msg": "string|description"
}