>

Login

Lo primero que debes hacer en tu implementación para empezar a usar el servicio Enlazatte es generar tu token de autenticación, una vez generado tu token, éste tendrá una vigencia de 72 horas, para generar el token debes realizar una petición tipo POST para ello debes enviar tu usuario y contraseña a la url base de tu ambiente de pruebas o productivo.

URL Base

La URL base es la dirección de internet que asignaremos a tu servicio Enlazatte, es una dirección personalizada para cada cliente y por medio de ésta el servicio sabe que las peticiones que lleguen ahí serán direccionadas al servidor donde tengas tu sistema Contpaqi.

Ej: http://tu-empresa.enlazatte.com/api-v1

Usuario

Este es el nombre de usuario que asignaremos a tu servicio enlazate, regularmente es tu cuenta de correo electrónico y en todas las generaciones de token que hagas tendrás que enviar éste nombre de usuario.

Ej: juan.perez@tuempres.com

Contraseña

Esta es la contraseña que tendrá asignado tu usuario, de igual forma que el usuario tendrás que enviar ésta contraseña en cada generación de token que hagas.

Ej: TuPSWD#123

Estos 3 datos te los proporcionaremos una vez que realices la contratación del servicio, es lo único que requieres para poder empezar a interactuar desde tu sistema ERP, Punto de Venta, CRM, Producción, etc. con tu sistema Contpaqi.

Request

La petición es una petición tipo POST, al endpoint /auth/login, como parámetros del Form envías las credenciales que indica la documentación que son user y password, en el encabezado del request se envía el Content-Type con valor application/x-www-form-urlencoded.

Una vez generado el Token de autenticación, éste tendrá una vigencia de 72 horas a partir de su generación, puedes guardar en tu base de datos el token generado y realizar un proceso de actualización de token automático cada 72 horas y con esto optimizar la cantidad de requests y tiempos de espera de tus peticiones ya que no es necesario generar un token para cada petición que haces.

public function getToken()
{
    $this->token = '';
    try {
        $response = $this->client->request('POST', 'auth/login', [
            'form_params' => [
                'email'    => $enlazatteUser,
                'password' => $enlazattePassword
            ]
        ]);

        $responseData  = json_decode($response->getBody()->getContents());

        $this->token   = $responseData->token;
        $this->message = 'Token correcto.';
    } catch (RequestException $e) {
        $statusCode = $e->getResponse()->getStatusCode();

        switch ($statusCode) {
            case 403:
                $this->message = 'Error de credenciales al obtener token.';
                break;
            case 422:
                $this->message = 'Error, request invalido.';
                break;
        }
    }

    return $this->token;
}
{
    "status": "ok",
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}





















                            
$("#register-form").validate({
  rules: {
    username: {
      required: true,
      minLength: 2,
      remote: "register.php"
    }
  },
  messages: {
    username: {
      required: "Enter your username",
      minLength: "At least 2 characters are necessary",
      remote: String.format("The name {0} is already in use")
    }
  }
});

Screenshot Insomnia

Login Insomnia

¿Listo para empezar?

Escribenos y comprueba lo rápido y sencillo que es enlazarte con Contpaqi, genera pedidos, cotizaciones, facturas, pagos, clientes, productos y timbra documentos desde tus propios sistemas aprovechando el protencial de tu empresa al máximo.