Autenticación de la API

Para interactuar con la API de ContawebAyM, primero debes obtener las credenciales de seguridad. Todas las peticiones protegidas deben enviar el access_token como Bearer y el tokenBD en el encabezado Token:

Authorization: Bearer <ACCESS_TOKEN>
Token: <TOKEN_BD>

NOTA

El método de obtención de tokens es para usuarios o las empresas que ya tienen la base de datos creada en la empresa. Asegúrate de mantener tu token de sesión seguro y no compartirlo, ya que representa tu identidad dentro de la API.

Solicitud de Token

Puedes obtener las credenciales realizando una petición POST (por ejemplo, desde Postman) a https://api.contawebaym.com/oauth/api/v1/obtenerTokenService. Esta llamada es la única que no requiere los encabezados Authorization y Token.

Este endpoint está destinado a integraciones: no devuelve menús ni información de presentación del ERP y no crea, reemplaza o elimina la sesión interactiva del usuario.

Terminal / Postman - Request POST

POST https://api.contawebaym.com/oauth/api/v1/obtenerTokenService
Content-Type: application/json

{
    "rucEmpresa": "20123456789",
    "usuario": "20123456789",
    "password": "mi_password_seguro"
}

Respuesta Exitosa

JSON - Response 200 OK

{
    "scope": "read write",
    "access_token": "<ACCESS_TOKEN>",
    "token_type": "bearer",
    "refresh_token": "<REFRESH_TOKEN>",
    "expires_in": 10786,
    "role": ["ADMIN"],
    "tokenBD": "<TOKEN_BD>"
}

IMPORTANTE: EL CAMPO TOKENBD

Debes conservar ambos valores: envía access_token como Authorization: Bearer <ACCESS_TOKEN> y tokenBD como Token: <TOKEN_BD> en todas las peticiones protegidas.

Respuesta Error

JSON - Response 401 Unauthorized

{
    "successful": false,
    "code": "UNAUTHORIZED",
    "message": "Datos incorrectos"
}

Ejemplo de Petición Autenticada

Aquí tienes un ejemplo utilizando cURL para un endpoint protegido. Se envían tanto el access_token como el tokenBD obtenidos durante la autenticación.

cURL - Petición GET autenticada

curl --request GET \
  --url "https://api.contawebaym.com/contabilidad/api/v1/getConfiguracionMes?type_conf_usuario=20123456789" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer <ACCESS_TOKEN>" \
  --header "Token: <TOKEN_BD>"