esofitec. CoreDocs

esofitec. CoreDocs

Workers y dispatchers / API estándar para a3ERP

Visión general

La API estándar para a3ERP (Sit.a3ERP.Dispatcher) es el worker que da a la API las operaciones de gestión habituales de a3ERP: dar de alta y mantener clientes, proveedores, artículos, documentos de venta y compra, etc. Es el worker estándar y reutilizable; cualquier instalación de la API que necesite escribir en a3ERP suele empezar por este.

Qué es un worker (en una frase)#

La API no escribe en a3ERP directamente: encola las peticiones y un proceso aparte —el worker— las va ejecutando contra a3ERP una a una. Este artículo describe qué operaciones trae el worker estándar; el funcionamiento general de los workers (por qué son un proceso aparte, cómo se despliegan, la licencia que consumen) está en Cómo funcionan los workers.

Qué cubre#

El worker estándar agrupa sus operaciones por familias:

  • Clientes — clientes, sus direcciones y sus contactos.
  • Proveedores.
  • Personas.
  • Artículos.
  • Pedidos — de venta y de compra.
  • Albaranes — de venta y de compra, incluida la facturación de un albarán de venta.
  • Facturas — de venta y de compra, incluida la impresión a PDF.
  • Auxiliares — series y centros de coste.

El detalle operación por operación está en Catálogo de operaciones.

Estándar y a medida#

  • Estándar — este worker, reutilizable en cualquier cliente. Puede haber más de uno (distintas versiones o variantes estándar).
  • A medida — workers hechos para un cliente concreto, con operaciones específicas que no entran en el estándar. Se documentan en su propia subsección de esta misma sección Workers y dispatchers.

Solo operaciones de escritura

Este worker se ocupa de crear, modificar y eliminar en a3ERP. Las consultas (listados de clientes, artículos, documentos…) no pasan por el worker: las resuelve la API directamente, como se explica en Configuración de endpoints y Uso.