Skip to main content
Version: 📄 PE

Introducción

👋 ¡Te damos la bienvenida a la documentación de la API Perú!

Esta página te ayudará a iniciar con nuestra API así puedas orientarte en los distintos endpoints que se encuentran a tu disposición. Comencemos con esta guía rápida.

El menú lateral izquierdo te servirá como guía general para encontrar la documentación según el recurso necesites trabajar. Cada sección tendrá un menú lateral derecho, que te mostrará las partes que componen el recurso.

tip

También puedes consultar nuestras preguntas frecuentes y listado de errores.

Autentificación​

Si leíste los primeros pasos📎 sabrás que todos los requests deberán ser autentificados mediante un access_token, este token debe indicarse en la cabecera de la petición.

Peticiones​

Las peticiones son HTTP REST por lo que se debe especificar el método que se va a utilizar, junto al método se debe enviar en la cabecera de la petición el token de acceso que permite la autenticación en la API.

  • GET, para obtener información de un recurso.
  • POST, para crear un recurso.
  • PUT, para modificar un recurso.
  • DELETE, para eliminar un recurso.

Ejemplo​

El envío es simple, este es un ejemplo de la generación de una factura electrónica. La documentación completa la encuentras en su sección correspondiente, "Documentos > Post un documento"

{
  "documentTypeId": 85,
  "officeId": 1,
  "emissionDate": 1686614400,
  "client": {
      "code": "987654321",
      "city": "Capital del Oeste",
      "company": "Capsule Corp",
      "municipality": "Capital del Oeste",
      "activity": "Development and research",
      "address": "Hoi Poi #750",
      "email": "dr@brief.pe"
  },
  "details": [
      {
          "netUnitValue": 9900,
          "quantity": 1,
          "taxId": "[1]",
          "discount": 0,
          "comment": "product example"
      }
  ]
}

Ayuda​

  • Si necesitas aprender como trabaja Bsale de forma general puedes revisar nuestra base de conocimiento.
  • Si tienes una duda puedes comunicarte con nosotros ingresando a la comunidad de slack 👋