Procesavo API

Objetivo

La API de Procesavo permite integrar sistemas externos para obtener información de usuarios, catálogos, clientes, proveedores y pedidos.

Autenticación

La autenticación se realiza enviando usuario y contraseña a https://api.procesavo.com/auth. El servidor regresará un token JWT que debe enviarse en cada petición en el encabezado:

Authorization: Bearer TU_ACCESS_TOKEN

Ejemplo de obtención de token:

curl -X POST "https://api.procesavo.com/auth" \\
  -H "Content-Type: application/json" \\
  -d '{"email":"demo@demo.com","password":"123456"}'

<?php
$ch = curl_init("https://api.procesavo.com/auth");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  "email" => "demo@demo.com",
  "password" => "123456"
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import java.net.http.*;
import java.net.URI;

public class AuthExample {
  public static void main(String[] args) throws Exception {
    var client = HttpClient.newHttpClient();
    var request = HttpRequest.newBuilder()
      .uri(URI.create("https://api.procesavo.com/auth"))
      .header("Content-Type", "application/json")
      .POST(HttpRequest.BodyPublishers.ofString("{\\"email\\":\\"demo@demo.com\\",\\"password\\":\\"123456\\"}"))
      .build();
    var response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

Respuesta exitosa (200)

{
  "message": Login correcto,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Nota sobre fecha

Todas las peticiones a los endpoints deberán realizarse mediante POST y recibir obligatoriamente el campo fecha_consulta en formato ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).

Nota sobre archivos

En las peticiones que incluyan archivos adjuntos, estos se mostrarán en formato Base64 dentro del JSON.

Códigos HTTP

Código	Significado	Descripción
200	OK	Solicitud exitosa.
400	Bad Request	Error en los parámetros o en el formato.
401	Unauthorized	Token inválido o ausente.
403	Forbidden	Sin permisos para acceder al recurso.
404	Not Found	Recurso inexistente.
500	Server Error	Error interno del servidor.