Guía Rápida de Uso: API Liquidator 5000

Bienvenido a la API de Liquidator 5000. Esta guía le proporcionará los pasos necesarios para comenzar a automatizar flujos de trabajo utilizando nuestra potente interfaz.

Configuración de la Solicitud

Para procesar sus documentos, deberá realizar una solicitud POST a nuestro endpoint principal. A continuación, se detallan los componentes de la solicitud que debe configurar en su cliente de API preferido (como Postman).

1. Endpoint y Método

• Método: POST

• URL: https://api.puente.solutions/process_documents/

2. Autenticación (Cabeceras / Headers) La API utiliza una clave para autenticar las solicitudes. Deberá incluir la siguiente cabecera en su llamada.

• Clave (Key): X-API-KEY

• Valor (Value): Su Clave de API Secreta (Esta clave única le será proporcionada por nuestro equipo).

3. Cuerpo de la Solicitud (Body) La solicitud debe enviarse con el tipo de cuerpo multipart/form-data. Este formato le permite enviar tanto datos de texto como archivos en la misma llamada. Deberá configurar los siguientes campos:

• workflow_id (Texto): Este campo es obligatorio y le dice a nuestra API qué tipo de tarea de extracción desea realizar. Consulte la sección “Workflows Disponibles” a continuación para ver los valores que puede utilizar.

• files (Archivo/s): Aquí es donde adjuntará los documentos que desea procesar. Puede enviar uno o varios archivos (PDF, JPG, PNG) en la misma solicitud. Actualmente, el tamaño total permitido está limitado a 100 MB.

Workflows Disponibles

Actualmente, con los siguientes workflows operacionales y estables:

extraer_facturas_resumido_v1

Este workflow está optimizado para procesar facturas argentinas (tipos A, B y C) y extraer la información esencial requerida para su registro y pago en sistemas de Cuentas a Pagar.

• Función principal: Extrae datos clave como la Razón Social del emisor, su CUIT, los detalles del comprobante (tipo, número, fecha), el desglose de importes y totales, y los datos de autorización fiscal como el CAE y su vencimiento.

alta_proveedor

Diseñado para automatizar el proceso de alta de proveedores, este workflow analiza una constancia de inscripción de AFIP (ya sea de Régimen General o de Monotributo) y extrae un perfil fiscal completo del contribuyente.

• Función principal: Captura la información fundamental para crear un nuevo proveedor en su sistema ERP, incluyendo CUIT, Razón Social o Nombre Completo, Domicilio Fiscal, Actividades Económicas declaradas, condición frente al IVA y Ganancias, y si es empleador.

Ejemplo de Respuesta

Tras procesar su solicitud, la API devolverá una respuesta en formato JSON con la siguiente estructura:

JSON

{
  "request_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "results": [
    {
      "filename": "documento1.pdf",
      "status": "success",
      "data": {
        "//...": "Aquí aparecerán los datos estructurados extraídos por el workflow seleccionado."
      }
    },
    {
      "filename": "documento2.jpg",
      "status": "failure",
      "data": {
        "error": "Descripción del problema."
      }
    }
  ]
}

• request_id: Un identificador único para toda su solicitud.

• results: Una lista que contiene el resultado del procesamiento para cada archivo enviado.

• status: Indica si el procesamiento del archivo fue exitoso (success) o fallido (failure).

• data: Si el estado es success, este objeto contendrá toda la información extraída. Si es failure, contendrá un mensaje de error.