Iniciar sesión

Endpoint: POST /login/

🚧 Usuarios de Sandbox:

A continuación listamos las dos cuentas definidas para el ambiente de sandbox.

Document Type

DNI Number

RUC Number

Username

Password

dni

123456789

sandbox_password

ruc

12345678911

sandbox_username

sandbox_password

¿Para qué sirve?

Al iniciar la operativa con nuestra API del SUNAT, lo primero que debes hacer es iniciar sesión en la Entidad con las credenciales del usuario final.

Parámetros requeridos

Parámetros

Descripción

provider

Proveedor de datos, debe ser siempre sunat

document_type

Tipo de documento

  • dni -> DNI
  • ruc -> RUC

password

Contraseña para ingresar al SUNAT

Parámetros opcionales

Parámetros

Descripción

dni

Requerido cuando document_type es dni

DNI

ruc

Requerido cuando document_type es ruc

RUC

username

Requerido cuando document_type es ruc

Usuario de SUNAT

Posibles respuestas

Parámetros

Descripción

session_key

Es el identificador que se utilizará para el resto de tus consultas al SUNAT

status

Resultado de la operación

Ejemplos

Iniciar sesión

POST /login/ HTTP/1.1
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-Api-Key: <API KEY>
Host: fiscal.sandbox.prometeoapi.com
Content-Length: 32

provider=sunat&document_type=ruc
curl --request POST \
     --url https://fiscal.sandbox.prometeoapi.com/login/ \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --header 'X-API-Key: <API KEY>' \
     --data provider=sunat \
     --data document_type=ruc
import requests

url = "https://fiscal.sandbox.prometeoapi.com/login/"

payload = "provider=sunat&document_type=ruc"
headers = {
    "Accept": "application/json",
    "Content-Type": "application/x-www-form-urlencoded",
    "X-API-Key": "<API KEY>"
}

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
# npm install api --save
const sdk = require('api')('@prometeoapi/v1.0#3q51t851al1l2m2w5');

sdk.server('https://fiscal.sandbox.prometeoapi.com');
sdk.post('/login', {
  provider: 'sunat',
  document_type: 'ruc'
}, {
  Accept: 'application/json',
  'X-API-Key': '<API KEY>'
})
  .then(res => console.log(res))
  .catch(err => console.error(err));

Respuesta exitosa

{
  "status": "logged_in",
  "key": "163d06b2-3378-4383-9868-71c2b6fb28da"
}