Sage 200c API - Contabilidad Extendida

Documentación de la API REST v1.2

Información General

API REST para consultas contables en Sage 200c con autenticación JWT.

URL Base: http://sage200capiconta.abmscloud.com/
⚠️ Autenticación requerida: Todos los endpoints requieren un token JWT excepto /, /health y /auth/login

🔐 Autenticación

POST /auth/login
Inicia sesión y obtiene un token JWT válido por 2 horas

Parámetros (form-data):

username: Nombre de usuario (admin, contable, sage_api)
password: Contraseña del usuario
curl -X POST "http://sage200capiconta.abmscloud.com/auth/login" \ -d "username=admin&password=12345678"
GET /auth/me
Obtiene información del usuario autenticado
curl -X GET "http://sage200capiconta.abmscloud.com/auth/me" \ -H "Authorization: Bearer {token}"

🏠 General

GET /
Información general de la API y endpoints disponibles
curl -X GET "http://sage200capiconta.abmscloud.com/"
GET /health
Verifica el estado de la API y conexión a base de datos
curl -X GET "http://sage200capiconta.abmscloud.com/health"

👥 Clientes

GET /api/v1/clientes
Lista de clientes con filtros opcionales y paginación

Query Parameters (opcionales):

CodigoEmpresa: Código de empresa
RazonSocial: Búsqueda parcial por razón social
CifDni: CIF/DNI del cliente
limit: Máximo de registros (1-1000, default: 100)
offset: Número de registros a saltar (default: 0)
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/clientes?limit=10&offset=0" \ -H "Authorization: Bearer {token}"

🏢 Proveedores

GET /api/v1/proveedores
Lista de proveedores con filtros opcionales
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/proveedores?limit=10" \ -H "Authorization: Bearer {token}"

📊 Plan de Cuentas

GET /api/v1/plancuentaspgc
Plan General Contable con filtros
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/plancuentaspgc?limit=10" \ -H "Authorization: Bearer {token}"

📋 Asientos

GET /api/v1/asientos
Asientos contables con filtros por fecha

Query Parameters (opcionales):

Ejercicio: Ejercicio contable (ej: 2024)
fecha_desde: Fecha desde (YYYY-MM-DD)
fecha_hasta: Fecha hasta (YYYY-MM-DD)
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/asientos?Ejercicio=2024&limit=10" \ -H "Authorization: Bearer {token}"

🧾 Facturas

GET /api/v1/movimientosfacturas
Movimientos de facturas de venta y compra
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/movimientosfacturas?limit=10" \ -H "Authorization: Bearer {token}"

🧮 IVA

GET /api/v1/movimientosiva
Registros de IVA soportado y repercutido
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/movimientosiva?limit=10" \ -H "Authorization: Bearer {token}"
GET /api/v1/librosregistrosiva
Libros registros de IVA consolidados

Query Parameters (opcionales):

TipoFactura: E=Emitida, R=Recibida
fecha_desde/fecha_hasta: Rango de fechas
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/librosregistrosiva?TipoFactura=E&limit=10" \ -H "Authorization: Bearer {token}"

🏭 Empresas

GET /api/v1/empresas
Información de empresas registradas
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/empresas?limit=10" \ -H "Authorization: Bearer {token}"

🏦 Bancos

GET /api/v1/bancos
Catálogo de entidades bancarias
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/bancos?limit=10" \ -H "Authorization: Bearer {token}"

💳 Cartera de Efectos

GET /api/v1/carteraefectos
Gestión de efectos comerciales
curl -X GET "http://sage200capiconta.abmscloud.com/api/v1/carteraefectos?limit=10" \ -H "Authorization: Bearer {token}"

📥 Importación Temporal

POST /api/v1/tmpime/clientesproveedores
Importar clientes/proveedores a tabla temporal
curl -X POST "http://sage200capiconta.abmscloud.com/api/v1/tmpime/clientesproveedores" \ -H "Authorization: Bearer {token}" \ -H "Content-Type: application/json" \ -d '[{ "CodigoEmpresa": "100", "ClienteOProveedor": "C", "CodigoClienteProveedor": "1000000001", "RazonSocial": "EMPRESA EJEMPLO S.L.", "CifDni": "B12345678" }]'
POST /api/v1/tmpime/plancuentaspgc
Importar plan de cuentas a tabla temporal
curl -X POST "http://sage200capiconta.abmscloud.com/api/v1/tmpime/plancuentaspgc" \ -H "Authorization: Bearer {token}" \ -H "Content-Type: application/json" \ -d '[{ "CodigoEmpresa": "100", "CodigoCuenta": "999999999", "Cuenta": "BANCOS E INSTITUCIONES 99" }]'
POST /api/v1/tmpime/movimientos
Importar movimientos/asientos a tabla temporal
curl -X POST "http://sage200capiconta.abmscloud.com/api/v1/tmpime/movimientos" \ -H "Authorization: Bearer {token}" \ -H "Content-Type: application/json" \ -d '[{ "CodigoEmpresa": "100", "Ejercicio": "2025", "FechaAsiento": "2025-01-01", "NumeroAsiento": 1, "CodigoCuenta": "430000004", "ImporteH": 559.69, "Debe_Haber": "H" }]'