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"
}

Updated about 2 years ago