Documentación API
Referencia de endpoints. Todas las URLs de ejemplo apuntan a http://localhost:8143.
API SAGE50 (AYUDA)
Devuelve la documentación de todos los endpoints
Ejemplo de petición
–
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
–
API SAGE50 (COMPRAS)
Crea un albarán de compra en Sage50.
Ejemplo de petición
http://localhost:8143/PostAlbCompra
Parámetros requeridos
{
"Empresa": "01",
"Serie": "SF",
"Numero": " 4",
"Fecha": "2025-06-18",
"Proveedor": "40000001",
"Observaciones": "Reposición",
"Almacen": "00",
"Fpago": "F1",
"lineas":[
{
"Articulo": "ARTLOTE",
"Descripcion": "Jamón 5J",
"Unidades": 3,
"PvpSinIva":250,
"TipoIva": "03",
"Dto1": 0.00,
"Dto2": 0.00,
"Usarlote":true,
"Lotes":
[
{
"Unidades":1,
"Lote":"L1000",
"Caducidad":"2025-12-25"
},
{
"Unidades":2,
"Lote":"L2000",
"Caducidad":"2025-12-24"
}
]
},
{
"Articulo": "1",
"Descripcion": "Cuchillo jamonero",
"Unidades": 2,
"PvpSinIva": 12.5,
"TipoIva": "03",
"Dto1": 5.00,
"Dto2": 0.00,
"Usarlote":false,
"Lotes":[]
}
]
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Empresa": "01",
"Numero": " 4",
"Fecha": "2025-06-18T00:00:00",
"Proveedor": "40000001",
"Observaciones": "Reposición",
"Almacen": "00",
"Fpago": "F1",
"lineas": [
{
"Articulo": "ARTLOTE",
"Descripcion": "Jamón 5J",
"Unidades": 3.0,
"PvpSinIva": 250.0,
"TipoIva": "03",
"Dto1": 0.00,
"Dto2": 0.00,
"Usarlote": true,
"Lotes": [
{
"Unidades": 1.0,
"Lote": "L1000",
"Caducidad": "2025-12-25T00:00:00"
},
{
"Unidades": 2.0,
"Lote": "L2000",
"Caducidad": "2025-12-24T00:00:00"
}
]
},
{
"Articulo": "1",
"Descripcion": "Cuchillo jamonero",
"Unidades": 2.0,
"PvpSinIva": 12.5,
"TipoIva": "03",
"Dto1": 5.00,
"Dto2": 0.00,
"Usarlote": false,
"Lotes": []
}
],
"CreatedAt": "2025-12-29T09:59:19.1247602+01:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa la empresa, se extraerá de la configuración
-Si no se informa número de albarán, se asignará el correlativo del contador de la serie
-Si se informa código de artículo vacío, se convertirá en comentario y se obviarán unidades e importes
-Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
Crea un pedido de compra en Sage50.
Ejemplo de petición
http://localhost:8143/PostPedCompra
Parámetros requeridos
{
"Empresa": "01",
"Numero": " 2",
"Fecha": "2025-06-18",
"Proveedor": "40000002",
"Observaciones": "Compra mobiliaria",
"Almacen": "A1",
"Fpago": "F1",
"lineas":[
{
"Articulo": "ARMARIO",
"Descripcion": "Armario de oficina",
"Unidades": 2,
"PvpSinIva":250,
"TipoIva": "I1",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Cajonera",
"Unidades": 2,
"PvpSinIva": 12.5,
"TipoIva": "I1",
"Dto1": 5.00,
"Dto2": 0.00
}
]
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Empresa": "01",
"Numero": " 2",
"Fecha": "2025-06-18T00:00:00",
"Proveedor": "40000002",
"Observaciones": "Compra mobiliaria",
"Almacen": "A1",
"Fpago": "F1",
"lineas": [
{
"Articulo": "ARMARIO",
"Descripcion": "Armario de oficina",
"Unidades": 2.0,
"PvpSinIva": 250.0,
"TipoIva": "I1",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Cajonera",
"Unidades": 2.0,
"PvpSinIva": 12.5,
"TipoIva": "I1",
"Dto1": 5.00,
"Dto2": 0.00
}
],
"CreatedAt": "2025-06-24T08:37:49.0221354+02:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa la empresa, se extraerá de la configuración
-Si no se informa número de albarán, se asignará el correlativo del contador de la serie
-Si se informa código de artículo vacío, se convertirá en comentario y se obviarán unidades e importes
-Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
API SAGE50 (CONTABILIDAD)
Cobra previsiones de clientes
Ejemplo de petición
http://localhost:8143/PostCobroPreviCli
Parámetros requeridos
{
"periodo": "2025",
"empresa": "",
"serie": "",
"factura": "1",
"orden": 0,
"cobrar_todo": false,
"importe": 700,
"fechacobro": "2025-12-15",
"banco": "57200001"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"periodo": "2025",
"empresa": "01",
"serie": "",
"factura": "1",
"orden": 0,
"cobrar_todo": false,
"importe": 700.0,
"fechacobro": "2025-12-15T00:00:00",
"banco": "57200001",
"CreatedAt": "0001-01-01T00:00:00",
"error": {
"code": "200",
"message": null
}
}Notas:
-Se debe informar el periodo
-Si no se informa la empresa, se usará la predeterminada
-Si no se informa el orden, se cobrará desde la primera previsión pendiente
-Si se informa cobrar_todo a true, se obviará el importe y el orden
API SAGE50 (LOGIN)
Genera un token de acceso para la autenticación usando grant_type=password
Ejemplo de petición
http://localhost:8143/GetToken?grant_type=password&username=Demo&password=Demo
Parámetros requeridos
grant_type
username
password
Parámetros opcionales
–
Ejemplo de respuesta
{
"access_token": "dd53fa9d-a035-4c34-8570-bca42195072e",
"token_type": "Bearer",
"expires_in": 3600
}API SAGE50 (MAESTROS)
Obtiene un cliente de Sage50.
Ejemplo de petición
http://localhost:8143/GetAllClients?codigo=43000100&defechaModificacion=08/01/2026&size=2&page=1
Parámetros requeridos
size,page
Parámetros opcionales
codigo, fecha
Ejemplo de respuesta
{
"Items": [
{
"Codigo": "00",
"Nombre": "SIN ALMACEN "
},
{
"Codigo": "01",
"Nombre": "Almacén Central "
},
{
"Codigo": "02",
"Nombre": "Almacén Norte "
},
{
"Codigo": "03",
"Nombre": "Almacén Sur "
},
{
"Codigo": "04",
"Nombre": "Almacén Este "
},
{
"Codigo": "05",
"Nombre": "Almacén Oeste "
}
],
"Pageable": {
"pageNumber": 1,
"pageSize": 100,
"totalElements": 6,
"totalPages": 1
}
}Obtiene un proveedor de Sage50.
Ejemplo de petición
http://localhost:8143/GetAllSupplier?codigo=43000100&defechaModificacion=08/01/2026&size=2&page=1
Parámetros requeridos
size,page
Parámetros opcionales
codigo, fecha
Ejemplo de respuesta
{
"Items": [
{
"Codigo": "40000001",
"Nombre": "PROVEEDOR GENERICO",
"NombreComercial": "PROVEEDOR GENERICO",
"Cif": "",
"FormaPago": "01",
"Direccion": "Alta inicial de proveedor genérico",
"CodigoPostal": "",
"Poblacion": "",
"Provincia": "",
"Pais": "034",
"Email": "",
"ContactoWeb": ""
},
{
"Codigo": "40000002",
"Nombre": "SUMINISTROS INDUSTRIALES NORTE SL",
"NombreComercial": "SUMINORTE",
"Cif": "B10000002",
"FormaPago": "02",
"Direccion": "Polígono Industrial Norte, Nave 12",
"CodigoPostal": "48013",
"Poblacion": "BILBAO",
"Provincia": "BIZKAIA",
"Pais": "034",
"Email": "administracion.suminorte@example.com",
"ContactoWeb": "www.suminorte-demo.es"
},
{
"Codigo": "40000003",
"Nombre": "DISTRIBUCIONES MEDITERRANEA DEMO SL",
"NombreComercial": "DISTRI MEDITERRANEA",
"Cif": "B10000003",
"FormaPago": "03",
"Direccion": "Avenida del Transporte 24",
"CodigoPostal": "46013",
"Poblacion": "VALENCIA",
"Provincia": "VALENCIA",
"Pais": "034",
"Email": "pedidos.mediterranea@example.com",
"ContactoWeb": "www.distrimediterranea-demo.es"
}
],
"Pageable": {
"pageNumber": 1,
"pageSize": 20,
"totalElements": 20,
"totalPages": 1
}
}Notas:
-La respuesta completa incluye el listado de los 20 proveedores demo (40000001 a 40000020).
Obtiene un almacén de Sage50.
Ejemplo de petición
http://localhost:8143/GetAlmacenes?codigo=00&size=2&page=1
Parámetros requeridos
size,page
Parámetros opcionales
codigo
Ejemplo de respuesta
{
"Items": [
{
"Codigo": "00",
"Nombre": "SIN ALMACEN ",
"rn": 1,
"totalItems": 6
},
{
"Codigo": "01",
"Nombre": "Almacén Central ",
"rn": 2,
"totalItems": 6
},
{
"Codigo": "02",
"Nombre": "Almacén Norte ",
"rn": 3,
"totalItems": 6
},
{
"Codigo": "03",
"Nombre": "Almacén Sur ",
"rn": 4,
"totalItems": 6
},
{
"Codigo": "04",
"Nombre": "Almacén Este ",
"rn": 5,
"totalItems": 6
},
{
"Codigo": "05",
"Nombre": "Almacén Oeste ",
"rn": 6,
"totalItems": 6
}
],
"Pageable": {
"pageNumber": 1,
"pageSize": 100,
"totalElements": 6,
"totalPages": 1
}
}Obtiene un cliente de Sage50.
Ejemplo de petición
http://localhost:8143/GetClient?codigo=43000100
Parámetros requeridos
codigo
Parámetros opcionales
–
Ejemplo de respuesta
{
"Codigo": "43000100",
"Nombre": "PACO GONZALEZ",
"NombreComercial": "RESTAURANTE PACO",
"Cif": "21478524C",
"Direccion": {
"Direccion": "Calle Gutenberg, 29",
"CodPost": "37184",
"Poblacion": "VILLARES DE LA REINA",
"Provincia": "SALAMANCA",
"Pais": "034"
},
"Contacto": {
"Contacto": "Leticia",
"Telefono": "721896321",
"Email": "leticia@restaurantepaco.com",
"Web": "www.restaurantepaco.com"
},
"Fpago": "",
"Vendedor": "01",
"Clifactura": "43000001",
"CreatedAt": "2025-06-12T15:01:54.5122569+02:00",
"error": {
"code": null,
"message": null
}
}Obtiene la lista de familias
Ejemplo de petición
http://localhost:8143/GetFamilias
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"CodigoFamilia": "00",
"NombreFamilia": "SIN FAMILIA",
"CtaCompra": "60000001",
"CtaVenta": "70000001"
},
{
"CodigoFamilia": "01",
"NombreFamilia": "MUEBLES",
"CtaCompra": "60000001",
"CtaVenta": "70000001"
},
{
"CodigoFamilia": "99",
"NombreFamilia": "SIN FAMILIA",
"CtaCompra": "60000001",
"CtaVenta": "70000001"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene un producto de Sage50.
Ejemplo de petición
http://localhost:8143/GetProduct?codigo=ARMARIO
Parámetros requeridos
codigo
Parámetros opcionales
–
Ejemplo de respuesta
{
"Codigo": "ARMARIO",
"Nombre": "ARMARIO ESQUINERO",
"Tipo_Iva": "03",
"PvpSinIva": 250.000000,
"Familia": "00",
"ControlStock": true,
"CreatedAt": "0001-01-01T00:00:00",
"error": {
"code": null,
"message": null
}
}Obtiene la lista de subfamilias
Ejemplo de petición
http://localhost:8143/GetSubfamilias
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"CodigoSubfamilia": "9999",
"FamiliaRelacionada": "",
"NombreSubfamilia": "SIN SUBFAMILIA"
},
{
"CodigoSubfamilia": "0001",
"FamiliaRelacionada": "01",
"NombreSubfamilia": "CAJON"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene un proveedor de Sage50.
Ejemplo de petición
http://localhost:8143/GetSupplier?codigo=40000003
Parámetros requeridos
codigo
Parámetros opcionales
–
Ejemplo de respuesta
{
"Codigo": "40000003",
"Nombre": "Aelis Consulting, S.L.",
"NombreComercial": "Aelis",
"Cif": "B84416783",
"Direccion": {
"Direccion": "Buenos Aires Kalea, 12",
"CodPost": "48001",
"Poblacion": "Bilbao",
"Provincia": "Vizcaya",
"Pais": "034"
},
"Contacto": {
"Contacto": "Juan",
"Telefono": "944317956",
"Email": "juan@aelis.es",
"Web": "www.aelis.es"
},
"Fpago": "",
"CreatedAt": "2025-06-12T15:01:37.8897329+02:00",
"error": {
"code": null,
"message": null
}
}Obtiene los tipos de IVA.
Ejemplo de petición
http://localhost:8143/GetTiposIVA
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": {
"codigoIva": "00",
"codigoTerritorio": 0
},
"iva": "IVA exento",
"porcentIva": 0.00,
"porcentRecargoEquivalencia": 0.00
},
{
"id": {
"codigoIva": "01",
"codigoTerritorio": 0
},
"iva": "IVA superreducido",
"porcentIva": 4.00,
"porcentRecargoEquivalencia": 0.50
},
{
"id": {
"codigoIva": "02",
"codigoTerritorio": 0
},
"iva": "IVA reducido",
"porcentIva": 10.00,
"porcentRecargoEquivalencia": 1.40
},
{
"id": {
"codigoIva": "03",
"codigoTerritorio": 0
},
"iva": "IVA general",
"porcentIva": 21.00,
"porcentRecargoEquivalencia": 5.20
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene los tipos de retención.
Ejemplo de petición
http://localhost:8143/GetTiposRetencion
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"Codigo": "01",
"Nombre": "RETENCIÓN SOPORTADA",
"Retencion": 19.00
},
{
"Codigo": "02",
"Nombre": "RETENCION SOPORTADA",
"Retencion": 20.00
},
{
"Codigo": "03",
"Nombre": "RETENCION SOPORTADA",
"Retencion": 15.00
},
{
"Codigo": "04",
"Nombre": "RETENCION SOPORTADA",
"Retencion": 1.00
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Crea un cliente en Sage50.
Ejemplo de petición
http://localhost:8143/PostClient
Parámetros requeridos
{
"Codigo": "43000010",
"Nombre": "FRANCISCO JOSE",
"NombreComercial": "RESTAURANTE PACO",
"Cif": "22222222K",
"Direccion": {
"Direccion": "C\\LAS ALEGRIAS 12",
"CodPost": "48006",
"Poblacion": "BILBAO",
"Provincia": "BIZKAIA",
"Pais": "P1"
},
"Contacto": {
"Contacto": "PACO",
"Telefono": "944317956",
"Email": "cliente@api.es",
"Web": "www.sageapi.es"
},
"Fpago": "F1",
"Vendedor": "V1",
"CliFactura":"",
"Tipo_iva":"21",
"Recargo":1,
"DiaPago1":10,
"DiaPago2":20,
"Dto1":5,
"Dto2":2,
"DtoPronto":8,
"Tiporet":"15",
"IBAN":"ES8600001111803333333333",
"PaisIdFiscal":"006"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Codigo": "43000010",
"Nombre": "FRANCISCO JOSE",
"NombreComercial": "RESTAURANTE PACO",
"Cif": "22222222K",
"Direccion": {
"Direccion": "C\\LAS ALEGRIAS 12",
"CodPost": "48006",
"Poblacion": "BILBAO",
"Provincia": "BIZKAIA",
"Pais": "P1"
},
"Contacto": {
"Contacto": "PACO",
"Telefono": "944317956",
"Email": "cliente@api.es",
"Web": "www.sageapi.es"
},
"Fpago": "F1",
"Vendedor": "V1",
"Clifactura": "",
"Tipo_iva": "21",
"Recargo": true,
"DiaPago1": 10,
"DiaPago2": 20,
"Dto1": 5.0,
"Dto2": 2.0,
"DtoPronto": 8.0,
"Tiporet": "15",
"IBAN": "ES8600001111803333333333",
"PaisIdFiscal": "006",
"CreatedAt": "2026-03-05T13:49:21.1542194+01:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa código, se usará el siguiente disponible
-Si el cliente existe, se modificarán los datos informados
-Si no se encuentra un mapeo y el valor es null, se usará el valor por defecto configurado
Crea un producto en Sage50.
Ejemplo de petición
http://localhost:8143/PostProduct
Parámetros requeridos
{
"Codigo": "01M58",
"Nombre": "CAJONERA BASIC 6",
"Familia":"01",
"Subfamilia":"0001",
"Tipo_Iva": "03",
"PvpSinIva": 5,
"ControlStock": false
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Codigo": "01M58",
"Nombre": "CAJONERA BASIC 6",
"Familia": "",
"Subfamilia": "",
"Tipo_Iva": "03",
"PvpSinIva": 5.0,
"ControlStock": false,
"CreatedAt": "2026-04-21T09:44:00.9312115+02:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Tipo de IVA. Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
-La familia y subfamilia informadas deben existir en Sage50
Si no se informa la familia, se usará la predeterminada
Crea un proveedor en Sage50.
Ejemplo de petición
http://localhost:8143/PostSupplier
Parámetros requeridos
{
"Codigo": "40000004",
"Nombre": "CONSERVAS JUAN S.L.",
"NombreComercial": "EL RINCON DE JUAN",
"Cif": "25478521S",
"Direccion": {
"Direccion": "C\\PUERTO 3",
"CodPost": "48006",
"Poblacion": "BILBAO",
"Provincia": "BIZKAIA",
"Pais": "P1"
},
"Contacto": {
"Contacto": "JUAN",
"Telefono": "944317956",
"Email": "info@api.com",
"Web": "www.apis50.com"
},
"Fpago": "F1",
"Tipo_iva":"21",
"Recargo":1,
"DiaPago1":10,
"DiaPago2":20,
"Dto1":5,
"Dto2":2,
"DtoPronto":8,
"Tiporet":"15",
"IBAN":"ES8600001111803333333333",
"PaisIdFiscal":"006"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Codigo": "40000004",
"Nombre": "CONSERVAS JUAN S.L.",
"NombreComercial": "EL RINCON DE JUAN",
"Cif": "25478521S",
"Direccion": {
"Direccion": "C\\PUERTO 3",
"CodPost": "48006",
"Poblacion": "BILBAO",
"Provincia": "BIZKAIA",
"Pais": "P1"
},
"Contacto": {
"Contacto": "JUAN",
"Telefono": "944317956",
"Email": "info@api.com",
"Web": "www.apis50.com"
},
"Fpago": "F1",
"Tipo_iva": "21",
"Recargo": true,
"DiaPago1": 10,
"DiaPago2": 20,
"Dto1": 5.0,
"Dto2": 2.0,
"DtoPronto": 8.0,
"Tiporet": "15",
"IBAN": "ES8600001111803333333333",
"PaisIdFiscal": "006",
"CreatedAt": "2026-03-06T09:30:20.815519+01:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa código, se usará el siguiente disponible
-Si el proveedor existe, se modificarán los datos informados
-Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
API SAGE50 (VENTAS)
Obtiene una factura de venta.
Ejemplo de petición
http://localhost:8143/GetClient?empresa=01&serie=SF&factura=1
Parámetros requeridos
empresa
serie
factura
Parámetros opcionales
–
Ejemplo de respuesta
{
"Empresa": "01",
"Serie": "SF",
"Factura": "1",
"Fecha": "2025-06-18T00:00:00",
"Cliente": "43000002",
"Almacen": "00",
"Fpago": "01",
"Vendedor": "01",
"lineas": [
{
"Articulo": "",
"Descripcion": "ALBARÁN SF-1 FECHA 18/06/2025",
"Unidades": 0.0,
"PvpSinIva": 0.0,
"TipoIva": "",
"Dto1": 0.0,
"Dto2": 0.0
},
{
"Articulo": "ARMARIO",
"Descripcion": "Armario de oficina",
"Unidades": 2.000000,
"PvpSinIva": 350.000000,
"TipoIva": "03",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Cajones de soporte",
"Unidades": 2.000000,
"PvpSinIva": 12.500000,
"TipoIva": "03",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "",
"Descripcion": "ALBARÁN SF-2 FECHA 18/06/2025",
"Unidades": 0.0,
"PvpSinIva": 0.0,
"TipoIva": "",
"Dto1": 0.0,
"Dto2": 0.0
},
{
"Articulo": "",
"Descripcion": "Entregar con albarán 1",
"Unidades": 0.000000,
"PvpSinIva": 0.000000,
"TipoIva": "",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Anclajes",
"Unidades": 10.000000,
"PvpSinIva": 0.500000,
"TipoIva": "03",
"Dto1": 0.00,
"Dto2": 0.00
}
],
"PDF": "JVBERi0xLjQKJdP0z....",
"CreatedAt": "2025-06-25T10:26:52.6320235+02:00",
"error": {
"code": null,
"message": null
}
}Crea un albarán de venta en Sage50.
Ejemplo de petición
http://localhost:8143/PostAlbVenta
Parámetros requeridos
{
"Empresa": "01",
"Serie": "SF",
"Numero": " 2",
"Fecha": "2025-06-18",
"Cliente": "43000001",
"DatosContado":
{
"Nombre":"JUAN",
"Direccion":"La dire",
"CodPost":"48902",
"Poblacion":"Pobla",
"Provincia":"Provi",
"Pais":"034",
"Cif":"25147852F",
"Telefono":"635895214",
"Email":"prueba@mail.com"
},
"Pedido": "Su pedido 34",
"Observaciones": "Observaciones",
"Almacen": "01",
"Fpago": "01",
"Vendedor": "01",
"lineas":[
{
"Articulo": "ARMARIO",
"Descripcion": "Esquinero de roble",
"Unidades": 2,
"PvpSinIva":1000,
"TipoIva": "I1",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Servicio instalación",
"Unidades": 1,
"PvpSinIva": 12.5,
"TipoIva": "I1",
"Dto1": 10.00,
"Dto2": 2.00
}
]
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Empresa": "01",
"Serie": "SF",
"Numero": " 2",
"Fecha": "2025-06-18T00:00:00",
"Cliente": "43000001",
"Datoscontado": {
"Nombre": "JUAN",
"Direccion": "La dire",
"Codpost": "48902",
"Poblacion": "Pobla",
"Provincia": "Provi",
"Pais": "034",
"Cif": "25147852F",
"Telefono": "635895214",
"Email": "prueba@mail.com"
},
"Pedido": "Su pedido 34",
"Observaciones": "Observaciones",
"Almacen": "01",
"Fpago": "01",
"Vendedor": "01",
"lineas": [
{
"Articulo": "ARMARIO",
"Descripcion": "Esquinero de roble",
"Unidades": 2.0,
"PvpSinIva": 1000.0,
"TipoIva": "I1",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Servicio instalación",
"Unidades": 1.0,
"PvpSinIva": 12.5,
"TipoIva": "I1",
"Dto1": 10.00,
"Dto2": 2.00
}
],
"CreatedAt": "2025-11-25T13:34:33.2908087+01:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa la empresa, se extraerá de la configuración
-Si no se informa la serie, se extraerá de la configuración
-Si no se informa número de albarán, se asignará el correlativo del contador de la serie
-Si se informa código de artículo vacío, se convertirá en comentario y se obviarán unidades e importes
-Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
Crea un pedido de venta en Sage50.
Ejemplo de petición
http://localhost:8143/PostPedVenta
Parámetros requeridos
{
"Empresa": "01",
"Serie": "",
"Numero": "",
"Fecha": "2026-12-31",
"Cliente": "43000001",
"DatosContado":
{
"Nombre":"Juanjo",
"Direccion":"c\\bienvenida 7",
"CodPost":"48902",
"Poblacion":"Bilbao",
"Provincia":"Bizkaia",
"Pais":"ES",
"Cif":"78521474F",
"Telefono":"619896587",
"Email":"juanjo@cliente.es"
},
"Observaciones": "ECE32026/00366",
"Almacen": "01",
"Fpago": "01",
"Vendedor": "01",
"lineas": [{
"Articulo": "ART1",
"Descripcion": "FORTUNE 315/80R22.5 156/150L (154/150M) FDR 606 M+S ",
"Unidades": 4,
"PvpSinIva": 229.0,
"TipoIva": "03",
"Dto1": 0.0,
"Dto2": 0.0
}, {
"Articulo": "ART10",
"Descripcion": "FORTUNE 315/70R22.5 156/150L (154/150M) FDR 606 M+S ",
"Unidades": 4,
"PvpSinIva": 212.8,
"TipoIva": "03",
"Dto1": 0.0,
"Dto2": 0.0
}
]
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Empresa": "01",
"Serie": "SF",
"Numero": "",
"Fecha": "2025-06-18T00:00:00",
"Cliente": "43000002",
"Observaciones": "Montar en oficina",
"Almacen": "A1",
"Fpago": "F1",
"Vendedor": "V1",
"lineas": [
{
"Articulo": "",
"Descripcion": "Entregar a Jose",
"Unidades": 0.0,
"PvpSinIva": 0.00,
"TipoIva": "",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Sage50",
"Unidades": 1.0,
"PvpSinIva": 483.5,
"TipoIva": "I1",
"Dto1": 10.00,
"Dto2": 2.00
}
],
"CreatedAt": "2025-06-24T08:12:06.554138+02:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa la empresa, se extraerá de la configuración
-Si no se informa la serie, se extraerá de la configuración
-Si no se informa número de albarán, se asignará el correlativo del contador de la serie
-Si se informa código de artículo vacío, se convertirá en comentario y se obviarán unidades e importes
-Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
Crea un presupuesto de venta en Sage50.
Ejemplo de petición
http://localhost:8143/PostPreVenta
Parámetros requeridos
{
"Empresa": "01",
"Serie": "",
"Numero": "",
"Fecha": "2025-06-18",
"Cliente": "43000002",
"Observaciones": "Montar en oficina",
"Almacen": "A1",
"Fpago": "F1",
"Vendedor": "V1",
"lineas":[
{
"Articulo": "",
"Descripcion": "Entregar a Jose",
"Unidades": 0,
"PvpSinIva":0.00,
"TipoIva": "",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Sage50",
"Unidades": 1,
"PvpSinIva": 483.5,
"TipoIva": "I1",
"Dto1": 10.00,
"Dto2": 2.00
}
]
}Parámetros opcionales
–
Ejemplo de respuesta
{
"Empresa": "01",
"Serie": "SF",
"Numero": "",
"Fecha": "2025-06-18T00:00:00",
"Cliente": "43000002",
"Observaciones": "Montar en oficina",
"Almacen": "A1",
"Fpago": "F1",
"Vendedor": "V1",
"lineas": [
{
"Articulo": "",
"Descripcion": "Entregar a Jose",
"Unidades": 0.0,
"PvpSinIva": 0.00,
"TipoIva": "",
"Dto1": 0.00,
"Dto2": 0.00
},
{
"Articulo": "1",
"Descripcion": "Sage50",
"Unidades": 1.0,
"PvpSinIva": 483.5,
"TipoIva": "I1",
"Dto1": 10.00,
"Dto2": 2.00
}
],
"CreatedAt": "2025-06-24T08:12:06.554138+02:00",
"error": {
"code": null,
"message": null
}
}Notas:
-Si no se informa la empresa, se extraerá de la configuración
-Si no se informa la serie, se extraerá de la configuración
-Si no se informa número de albarán, se asignará el correlativo del contador de la serie
-Si se informa código de artículo vacío, se convertirá en comentario y se obviarán unidades e importes
-Si no se encuentra un mapeo se usará el valor por defecto configurado si el valor es null
DUKA (COMPRAS)
Actualiza las observaciones de la cabecera de los pedidos de compra
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/compras/pedido/actualiza-observaciones-cabecera
Parámetros requeridos
{
"id": {
"codigoEmpresa": 0,
"ejercicioPedido": 0,
"seriePedido": "string",
"numeroPedido": 0
},
"observaciones": "string"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"http_status": 201,
"message": "Observaciones de pedido proveedor actualizadas correctamente"
}Envía el status de las lecturas de las expediciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/compras/pedido/cerrar
Parámetros requeridos
{
"id": {
"codigoEmpresa": 1,
"ejercicioPedido": 2025,
"seriePedido": "40000002",
"numeroPedido": 2
},
"statusCerradoExpediciones":-2
}Parámetros opcionales
–
Ejemplo de respuesta
{
"http_status": 201,
"message": "Pedido cerrado: cabecera y lineas actualizadas"
}Envía el status de las lecturas de líneas de las expediciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/compras/pedido/cerrar-linea
Parámetros requeridos
Parámetro:statusCerradoExpediciones=-1
{
"id": {
"codigoempresa": 1,
"ejerciciopedido": 2026,
"lineasposicion": "a9ffa0c4-2af9-8048-94b1-80692be12eb9",
"numeropedido": 1,
"orden": 5,
"seriepedido": "40000002"
}
}Parámetros opcionales
–
Ejemplo de respuesta
{
"http_status": 201,
"message": "El status de la línea ha sido actualizado satisfactoriamente"
}Obtiene las recepciones dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/compras/pedido/get-recepciones_SGA_Picking?codigoEmpresa=1&numeroTerminal=0
Parámetros requeridos
codigoEmpresa
numeroTerminal
Parámetros opcionales
–
Ejemplo de respuesta
Respuesta extensa: devuelve result_list con cabecera del pedido, líneas y lecturas de las recepciones. Consulte la documentación original para el ejemplo JSON completo.
DUKA (CONTABILIDAD)
Obtiene la lista de efectos dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/cartera-efectos/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 23,
"totalPages": 23,
"result_list": [
{
"id": {
"codigoEmpresa": 1,
"numeroEfecto": 5,
"prevision": "C"
},
"movCartera": "0d3ee049-506d-b14e-9d7e-9e8280a5b76f",
"numeroOrdenEfecto": 1,
"statusBorrado": -1,
"ejercicio": 2024,
"serieFactura": "PRIUEBA",
"factura": 1,
"comentario": "Factura nº 1",
"codigoClienteProveedor": "000001",
"codigoCuenta": "430000001",
"contrapartida": "572000000",
"fechaEmision": "20/05/2024",
"fechaFactura": "20/05/2024",
"fechaVencimiento": "20/05/2024",
"importeEfecto": 2.42,
"importePendiente": 2.42,
"documentoConciliacion": "COB0000001",
"numeroEfecto": 5,
"prevision": "C",
"codigoEmpresa": 1
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Notas:
-El objeto de cada efecto contiene numerosos campos adicionales. Consulte la documentación original para el ejemplo JSON completo.
DUKA (INVENTARIO)
Obtiene el stock de artículos dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/android-connector/articulos/stock/get-all/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 14,
"totalPages": 14,
"result_list": [
{
"articulo": "0000000004",
"codigoEmpresa": 1,
"ejercicio": 2025,
"unidades": 500,
"fecha": null,
"almacen": "",
"lote": "",
"situacion": "",
"periodo": 99
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene el stock por artículo
Ejemplo de petición
http://localhost:8143/multinnector_sga/android-connector/articulos/stock/por-articulo?codigoEmpresa=1&ejercicio=2025&articulo=0000000001
Parámetros requeridos
codigoEmpresa
ejercicio
articulo
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [],
"http_status": 200,
"message": "Consulta realizada con exito"
}Obtiene las agrupaciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/agrupaciones/find-by-empresa-page?codigoEmpresa=1&page=0&size=1000
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
–
Obtiene el stock dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/stock/get-byCodigoEmpresaExt?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": {
"codigoEmpresa": 1,
"ejercicio": 2024,
"codigoArticulo": "55555",
"codigoAlmacen": "003",
"periodo": 7,
"partida": "31",
"tipoUnidadMedida_": "",
"codigoColor_": "",
"codigoTalla01_": ""
},
"unidadEntrada": 0,
"unidadSalida": 0,
"unidadSaldo": 0,
"precioMedio": 0,
"fechaUltimaEntrada": "18/07/2024",
"fechaUltimaSalida": null,
"fechaCaducidad": null,
"ubicacion": "",
"statusRecalculo": -1,
"idAcumuladoStock": "3850f968-644f-47b4-864f-3d4194af3d49",
"enviarAPI": 0,
"idProcesoImportacion": "00000000-0000-0000-0000-000000000000"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene las cabeceras de palet dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_CabeceraPalet/find-by-empresa?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"sscc": "184370080010000316",
"usrContadorPalet": 0,
"codigoEmpresa": 1,
"codigoAlmacen": "000",
"usrCodigoUbicacion": "0002",
"usrCodigoTipoContenedor": "CAJA ",
"fechaRegistro": "03/09/2025 11:40:29",
"horaRegistro": 0.40560828703746665,
"unidades": 0,
"peso": 0,
"statusEnviadoOffline": 0,
"fechaEnvioOffline": null,
"horaEnvioOffline": 0,
"movPosicion": "a24d1460-6e4a-41af-a855-85b76eba66cc",
"codigoCliente": "",
"descripcion": ""
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene las cabeceras de palet dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_CabeceraPalet/find-by-empresa-page?codigoEmpresa=1&page=0&size=1000
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 0,
"totalPages": 0,
"result_list": [],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la configuración del terminal dado su número
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_MntConfigTerminales/duka-find-by-numero-terminal?numeroTerminal=1
Parámetros requeridos
numeroTerminal
Parámetros opcionales
–
Ejemplo de respuesta
–
Obtiene los mantenimientos de los tipos de lecturas dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_MntTiposLecturas/find-by-empresa?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "codigoEmpresa": 1, "usrCodigoTipoPesada": 0 },
"usrTipoPesada": "Normal"
},
{
"id": { "codigoEmpresa": 1, "usrCodigoTipoPesada": 1 },
"usrTipoPesada": "Muestra"
},
{
"id": { "codigoEmpresa": 1, "usrCodigoTipoPesada": 2 },
"usrTipoPesada": "Merma"
},
{
"id": { "codigoEmpresa": 1, "usrCodigoTipoPesada": 3 },
"usrTipoPesada": "Rechazo"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene los tipos de contenedores
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_TiposContenedores/find-all
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"usrCodigoTipoContenedor": "CAJA",
"usrDescripcionTipoContenedor": "CAJA",
"usrCodigoTipoUbicacion": "",
"usrDigitoExtensionSSCC": 1
},
{
"usrCodigoTipoContenedor": "PALET",
"usrDescripcionTipoContenedor": "PALET",
"usrCodigoTipoUbicacion": "",
"usrDigitoExtensionSSCC": 3
},
{
"usrCodigoTipoContenedor": "PERCHA",
"usrDescripcionTipoContenedor": "PERCHA",
"usrCodigoTipoUbicacion": "",
"usrDigitoExtensionSSCC": 4
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Lista los tipos de pesajes
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_TiposPesaje/find-all
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Lista los tipos de ubicaciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_TiposUbicaciones/find-by-empresa?codigoEmpresa=0
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [],
"http_status": 200,
"message": "Consulta realizada con exito"
}Obtiene las ubicaciones de cabecera dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_UbicacionCabecera/find-by-empresa-page?codigoEmpresa=1&page=-1&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 12,
"totalPages": 12,
"result_list": [
{
"id": { "codigoEmpresa": 1, "usrCodigoUbicacion": "_DEF" },
"usrDescripcionUbicacion": "",
"codigoAlmacen": "000",
"usrCodigoZonaAlmacen": "",
"usrPasillo": "",
"usrFila": "",
"usrAltura": "",
"usrPosicion": "",
"ordenRecorrido": 0,
"usrCamara": 0,
"usrCodigoTipoUbicacion": "",
"usrUnidadesUbicacion": 0,
"pesoMaximo": 0,
"codigoEmpresa": 1,
"usrCodigoUbicacion": "_DEF"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la ubicación de movimientos dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/Vis_USR_UbicacionArtEstado/getAllByCodigoEmpresa?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"codigoEmpresa": 1,
"usrCodigoUbicacion": "_DEF",
"codigoArticulo": "0000000011",
"partida": "",
"codigoAlmacen": "000",
"numeroSerieLc": "",
"sscc": "",
"unidades": 2,
"unidadesEntrada": 302,
"unidadesSalida": 300,
"unidades2_": 2,
"unidadesEntrada2_": 302,
"unidadesSalida2_": 300,
"fechaCaduca": "01/01/2000",
"fechaEntrada": "19/11/2025"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Notas:
-La respuesta original incluye numerosas ubicaciones por artículo/almacén. Consulte la documentación original para el listado completo.
Obtiene la ubicación de movimientos dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/Vis_USR_UbicacionArtEstado/getAllByCodigoEmpresa-page?codigoEmpresa=1&page=0&size=1000
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 11,
"totalPages": 1,
"result_list": [
{
"codigoEmpresa": 1,
"codigoAlmacen": "",
"usrCodigoUbicacion": "",
"codigoArticulo": "ART1",
"partida": "",
"numeroSerieLc": "",
"sscc": "",
"unidades": 97.000000,
"unidades2_": 97.000000,
"unidadesEntrada": 100.000000,
"unidadesSalida": 3.000000,
"unidadesEntrada2_": 100.000000,
"unidadesSalida2_": 3.000000,
"fechaCaduca": "01/01/2000",
"fechaEntrada": "25/05/2026"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 1
}Notas:
-La respuesta original incluye 11 elementos (ART1, ARMARIO, ART0, ART10, ARTLOTE, ARTSERIE, ARTTALCOL…). Consulte la documentación original para el listado completo.
Obtiene la ubicación de movimientos dado su código de empresa y una lista de artículos
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/Vis_USR_UbicacionArtEstado/getStockByCodigosArticulo?codigoEmpresa=1&codigosArticulo=0000000011&codigosArticulo=0000000012
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"codigoEmpresa": 1,
"usrCodigoUbicacion": "_DEF",
"codigoArticulo": "0000000013",
"partida": "12121",
"codigoAlmacen": "000",
"numeroSerieLc": "",
"sscc": "",
"unidades": 10,
"unidadesEntrada": 10,
"unidadesSalida": 0,
"unidades2_": 10,
"unidadesEntrada2_": 10,
"unidadesSalida2_": 0,
"fechaCaduca": "01/01/2000",
"fechaEntrada": "03/11/2025"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}DUKA (LECTURAS)
Envía las lecturas de las expediciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_LecturasDuka/
Parámetros requeridos
[
{
"id": {
"numeroTerminal": 0,
"fechaRegistro": "2026-01-13T12:48:55.960Z",
"movPosicion": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"codigoEmpresa": 0,
"origenMovimiento": "string",
"ejercicioDocumento": 0,
"serieDocumento": "string",
"documento": 0,
"movOrigen": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"codigoArticulo": "string",
"partida": "string",
"numeroSerieLc": "string",
"sscc": "string",
"codigoAlmacen": "stri",
"usrCodigoUbicacion": "string",
"unidades": 0,
"unidades2": 0,
"comentario": "string",
"statusBorrado": 0,
"usrCodigoTipoPesada": 0,
"usrCodigoUbicacionBorrado": "string",
"fechaCaducidad": "2026-01-13T12:48:55.960Z",
"factorConversion_": 0,
"ssccpicking": "string",
"numeroCaja": 0,
"numeroPalet": 0,
"cajaCerrada": 0,
"paletCerrado": 0,
"versionTerminalPDT": "string"
}
]Parámetros opcionales
–
Ejemplo de respuesta
Devuelve el objeto pedido (cabecera completa con todos sus campos). Consulte la documentación original para el ejemplo JSON completo.
Elimina lecturas registradas
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_LecturasDuka/borra-lectura
Parámetros requeridos
{
"id": {
"movPosicion": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"usrCodigoUbicacionBorrado": "string"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"id": {
"movPosicion": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"usrCodigoUbicacionBorrado": "string"
}Elimina lecturas registradas por línea
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_LecturasDuka/borra-lecturas-por-linea-pk
Parámetros requeridos
{
"codigoEmpresa": 1,
"ejercicioDocumento": 2025,
"serieDocumento": "DAVID_ALMAR",
"documento": 1,
"lineasPosicion": "89580460-FD6D-4F59-B25B-2214F1CF4AF5",
"usrCodigoUbicacionBorrado": "PLY EXP"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"codigoEmpresa": 1,
"ejercicioDocumento": 2025,
"serieDocumento": "DAVID_ALMAR",
"documento": 1,
"lineasPosicion": "89580460-FD6D-4F59-B25B-2214F1CF4AF5",
"usrCodigoUbicacionBorrado": "PLY EXP"
}DUKA (LOGIN)
Login app
Ejemplo de petición
http://localhost:8143/multinnector_sga/android-connector/usuario-app/login?user=Pablo&password=1234&token=23f095fe-0adc-4455-bd45-fba265e423c1
Parámetros requeridos
user
password
token
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": {
"codigoEmpresa": 1,
"aelCodigoUsuario": 2,
"aelUsuario": "Pablo",
"aelPassword": "1234",
"nombre": "Pablo",
"apellido1": "Martín",
"apellido2": "María",
"aelContadorPVE": 0,
"aelContadorPCO": 0,
"aelContadorALC": 0,
"aelContadorALP": 0,
"aelContadorFAP": 0,
"aelContadorFAC": 0,
"aelContadorCliN": 0,
"aelOpcionesMenu": "",
"aelActivo": -1,
"codigoComisionista": 1,
"codigoTransportista": 0,
"aelSeriePVE": "",
"aelSeriePCO": "",
"aelSerieALC": "",
"aelSerieALP": "",
"aelSerieFAC": "",
"aelSerieFAP": "",
"aelEstado": 0,
"aelEnlaceCon": "200",
"numeroTerminal": null
},
"http_status": 200,
"message": "Consulta realizada con éxito"
}Login API
Ejemplo de petición
http://localhost:8143/multinnector_sga/auth/login
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"access_token": "23f095fe-0adc-4455-bd45-fba265e423c1",
"http_status": 200,
"token_type": "Bearer",
"message": "Autenticación correcta",
"expires_in": 3477,
"user": {
"username": "DEMO",
"password": null,
"roles": [
{ "id": 2, "name": "ROLE_ADMIN" }
],
"token": {
"id": "23f095fe-0adc-4455-bd45-fba265e423c1",
"creationDate": "2025-10-31T10:02:58.028+01:00",
"expirationDate": "2025-10-31T11:02:58.028+01:00"
},
"enabled": true,
"authorities": [
{ "authority": "ROLE_ADMIN" }
],
"accountNonLocked": true,
"accountNonExpired": true,
"credentialsNonExpired": true
}
}Genera un token de acceso para la autenticación usando grant_type=password
Ejemplo de petición
http://localhost:8143/multinnector_sga/auth/token?grant_type=password&username=Demo&password=Demo
Parámetros requeridos
grant_type
username
password
Parámetros opcionales
–
Ejemplo de respuesta
{
"access_token": "dd53fa9d-a035-4c34-8570-bca42195072e",
"token_type": "Bearer",
"expires_in": 3600
}Parámetros Usuarios
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/USR_MntConfigTerminales/duka-find-by-numero-terminal?numeroTerminal=101&token=23f095fe-0adc-4455-bd45-fba265e423c1
Parámetros requeridos
numeroTerminal
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "usrCodigoClaveTerminal": "DUKA_CerrarLineaAutomatico", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": "NO"
},
{
"id": { "usrCodigoClaveTerminal": "DUKA_CodigoAlmacenContenedoresPerdidos", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": "0"
},
{
"id": { "usrCodigoClaveTerminal": "DUKA_ConfirmarPartidaSugerida", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": "NO"
},
{
"id": { "usrCodigoClaveTerminal": "DUKA_CriterioSeleccionPartida", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": ""
},
{
"id": { "usrCodigoClaveTerminal": "DUKA_EnviarLecturasExpAlGuardar", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": "NO"
},
{
"id": { "usrCodigoClaveTerminal": "DUKA_EnviarLecturasRecAlGuardar", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": "NO"
},
{
"id": { "usrCodigoClaveTerminal": "DUKA_EnviarTraspasosAlGuardar", "numeroTerminal": 1 },
"usrDescripcionClave": "",
"usrValorClaveTerminal": "NO"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Control de versión
Ejemplo de petición
http://localhost:8143/multinnector_sga/version/check?version=1.26.0611.01
Parámetros requeridos
version
Parámetros opcionales
–
Ejemplo de respuesta
{
"status": "OK",
"forceUpdate": false,
"message": "Versión compatible.",
"latestVersion": "1.26.0611.01"
}DUKA (MAESTROS)
Envía registro de incidencias
Ejemplo de petición
http://localhost:8143/multinnector/sage/sga_picking/USR_UbicacionConfirmPDAErr/graba_incidencias
Parámetros requeridos
[
{
"movPosicion": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"codigoEmpresa": 0,
"ejercicioDocumento": 0,
"serieDocumento": "string",
"documento": 0,
"lineasPosicion": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"pesosPosicion": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"origenMovimiento": "string",
"tipoMovimiento": "string",
"codigoAlmacen": "string",
"usrCodigoUbicacion": "string",
"codigoArticulo": "string",
"partida": "string",
"numeroSerieLc": "string",
"sscc": "string",
"unidades": 0,
"unidades2_": 0,
"motivoError": "string",
"fechaRegistro": "2026-03-12T10:10:19.216Z",
"horaRegistro": 0,
"usrTerminalConfirmacion": 0,
"codigoUsuario": 0,
"codigoZona": 0,
"numeroOrdenPreparacion": 0,
"numeroOrdenRecepcion": 0,
"numeroOrdenExpedicion": 0
}
]Parámetros opcionales
–
Ejemplo de respuesta
Devuelve el mismo array de incidencias registradas (con fechaRegistro actualizada).
Obtiene los códigos de barras de la empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/android-connector/codigos-de-barras-sage/find-by-empresa?codigoEmpresa=1&page=0&size=100
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 4,
"totalPages": 1,
"result_list": [
{
"id": {
"codigoEmpresa": 1,
"codigoDeBarras": "234235235235235253",
"codigoArticulo": "ART1"
},
"unidadMedida1_": "",
"factorConversion_": 1,
"unidades": 1.000000
},
{
"id": {
"codigoEmpresa": 1,
"codigoDeBarras": "8412345010019",
"codigoArticulo": "ARTLOTE"
},
"unidadMedida1_": "",
"factorConversion_": 1,
"unidades": 1.000000
}
],
"http_status": 200,
"page": {
"number": 2,
"size": 2,
"numberOfElements": 2,
"totalElements": 4,
"totalPages": 2,
"first": false,
"last": true,
"empty": false
},
"message": "Consulta realizada con éxito",
"currentPage": 2
}Obtiene los códigos de barras de la empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/android-connector/codigos-de-barras-sage/find-by-empresa_Duka?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoDeBarras": "0000000000109" },
"codigoArticulo": "0000000002",
"unidadMedida1_": "",
"factorConversion_": 1,
"unidades": 1
},
{
"id": { "codigoEmpresa": 1, "codigoDeBarras": "0000000000116" },
"codigoArticulo": "0000000003",
"unidadMedida1_": "",
"factorConversion_": 1,
"unidades": 1
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene los códigos de barras de la empresa de forma paginada
Ejemplo de petición
http://localhost:8143/multinnector_sga/android-connector/codigos-de-barras-sage/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 19,
"totalPages": 19,
"result_list": [
{
"codigoEmpresa": 1,
"codigoArticulo": "0000000002",
"factorConversion_": 1,
"unidadMedida1_": "",
"unidades": 1,
"codigoDeBarras": "0000000000109"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene las agrupaciones dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/agrupaciones/find-by-empresa?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoArticulo": "55555", "codigoAgrupacion": 1 },
"agrupacion": "Caja de 12",
"descripcionArticulo": "CACHOPO",
"codigoAlternativo": "1000000055555",
"unidadesAgrupacion": 12,
"precioAgrupacion": 1056,
"precioAgrupacionCompras": 600,
"precioVenta": 88,
"precioCompra": 50,
"idAgrupaciones": "711b9e95-7327-1349-9d68-a89a40d64535"
},
{
"id": { "codigoEmpresa": 1, "codigoArticulo": "55555", "codigoAgrupacion": 2 },
"agrupacion": "Palet de 12 Cajas de 12 Unidades",
"descripcionArticulo": "CACHOPO",
"codigoAlternativo": "2000000055555",
"unidadesAgrupacion": 144,
"precioAgrupacion": 12672,
"precioAgrupacionCompras": 7200,
"idAgrupaciones": "df30362e-5d4b-c940-8881-2415c0c7a121"
},
{
"id": { "codigoEmpresa": 1, "codigoArticulo": "55555", "codigoAgrupacion": 3 },
"agrupacion": "CAJA DE 3",
"descripcionArticulo": "Ibuprofeno 600 mg (blíster)",
"codigoAlternativo": "20000000555556",
"unidadesAgrupacion": 3,
"precioAgrupacion": 264,
"precioAgrupacionCompras": 150,
"idAgrupaciones": "1877f693-ff40-4a43-ba45-542494a928e3"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Notas:
-Cada agrupación incluye además campos de precios/descuentos por tarifa. Consulte la documentación original para el detalle completo.
Obtiene la lista de artículos de clientes dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/articulo-cliente/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 22,
"totalPages": 22,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoArticulo": "0000000002", "codigoCliente": "88888" },
"comentario": "Albarán:2025/COM/1",
"codigodelCliente": "0000000002",
"automatico": -1,
"precioOferta": 100,
"ejercicioUltimoAlbaran": 2025,
"serieUltimoAlbaran": "COM",
"numeroUltimoAlbaran": 1,
"fechaUltimoAlbaran": "05/03/2025",
"unidadesUltimoAlbaran": 1,
"precioUltimoAlbaran": 400,
"idArticuloCliente": "e7866af3-b18f-a247-9196-8acfdf2f7344",
"codigoEmpresa": 1,
"codigoArticulo": "0000000002",
"codigoCliente": "88888"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene los datos de un cliente dado su código de empresa
Ejemplo de petición
http://localhost:8143/sage/maestros/clientes/find-by-empresa-and-bajaempresa-page?codigoEmpresa=1&page=0&size=10
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"content": [
{
"id": { "codigoEmpresa": 1, "codigoCliente": "000001" },
"siglaNacion": "ES",
"cifDni": "87678876R",
"cifEuropeo": "ES87678876R",
"fechaAlta": "25/04/2025",
"codigoContable": "430000001",
"codigoDivisa": "USD",
"codigoCondiciones": 2,
"razonSocial": "SERVICIOS COMERCIALES MATEOS",
"nombre": "Jose Mateos Prada",
"domicilio": "CL/Esperanza,4,1-1-B",
"actividad": "Financieras",
"formadePago": "Un plazo a 30 días",
"codigoPostal": "02085",
"municipio": "VIVEROS",
"codigoProvincia": "02",
"provincia": "ALBACETE",
"codigoNacion": 108,
"nacion": "ESPAÑA",
"telefono": "666789876",
"email1": "josematprada@gmail.com",
"idCliente": "f3678b86-6872-da4f-ba1a-ea0c75c55b74",
"codigoCliente": "000001",
"codigoEmpresa": 1,
"iban": "1465 0100 94 1234567890"
}
],
"pageable": {
"sort": { "empty": true, "sorted": false, "unsorted": true },
"offset": 0,
"pageNumber": 0,
"pageSize": 1,
"paged": true,
"unpaged": false
},
"totalElements": 6,
"totalPages": 6,
"last": false,
"size": 1,
"number": 0,
"numberOfElements": 1,
"first": true,
"empty": false
}Notas:
-Cada cliente devuelve la ficha completa con más de 150 campos. Consulte la documentación original para el ejemplo JSON íntegro.
Obtiene la lista de domicilios dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/domicilios/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 28,
"totalPages": 28,
"result_list": [
{
"id": {
"codigoEmpresa": 1,
"tipoDomicilio": "E",
"codigoCliente": "000001",
"numeroDomicilio": 0
},
"codigoTransportista": 0,
"tipoPortes": "D",
"nombre": "Jose Mateos Prada",
"razonSocial": "SERVICIOS COMERCIALES MATEOS",
"codigoSigla": "CL",
"viaPublica": "Esperanza",
"numero2": "4",
"escalera": "1",
"piso": "1",
"puerta": "B",
"domicilio": "CL/Esperanza,4,1-1-B",
"codigoPostal": "02085",
"municipio": "VIVEROS",
"codigoProvincia": "02",
"provincia": "ALBACETE",
"codigoNacion": 108,
"nacion": "ESPAÑA",
"telefono": "666789876",
"horarioDomicilioLc": "17:00 a 21:00",
"idDomicilio": "85307feb-566a-3843-a54f-8b3b3b8c65c7",
"codigoEmpresa": 1,
"codigoCliente": "000001",
"tipoDomicilio": "E",
"numeroDomicilio": 0
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la lista de Subfamilias dado su código de empresa y familia
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/familias/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 13,
"totalPages": 13,
"result_list": [
{
"id": {
"codigoEmpresa": 1,
"codigoFamilia": "01000",
"codigoSubfamilia": "**********"
},
"descripcion": "Alimentación",
"grupoIva": 1,
"grupoIvaCompras": 1,
"trataNumerosSerieLc": 0,
"publicarInternet": 0,
"idFamilia": "ba733032-b015-d140-8f60-fe174b8279e4",
"publicarGCRM": -1,
"codigoFamilia": "01000",
"codigoEmpresa": 1,
"codigoSubfamilia": "**********"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene los datos de formas de pago dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/formas-pago/find-by-empresa-page?codigoEmpresa=1&page=0&size=0
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 5,
"totalPages": 5,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoCondiciones": 1 },
"condiciones": "Contado",
"formadePago": "Contado",
"codigoTipoEfecto": 11,
"numeroPlazos": 1,
"diasPrimerPlazo": 0,
"diasEntrePlazos": 0,
"controlarFestivos": -1,
"diasRetroceso": 0,
"mesesComerciales": 0,
"idCondicion": "208af216-d158-854c-943b-e1279587226c",
"codigoEmpresa": 1,
"codigoCondiciones": 1
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la lista de grupos de IVA
Ejemplo de petición
http://localhost:8143/multinnector/sage/maestros/grupos-iva/find-all
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "grupoIva": 1, "fechaInicio": "date" },
"marcaExento": 0,
"codigoIvaconRecargo": 20,
"codigoIvasinRecargo": 16
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene la lista de proveedores dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/proveedores/find-by-empresa-page?codigoEmpresa=1&page=0&size=10
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 3,
"totalPages": 3,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoProveedor": "40000001" },
"razonSocial": "PROVEEDOR",
"codigoContable": "40000001",
"codigoCondiciones": 0,
"formadePago": "",
"codigoPostal": " ",
"codigoNacion": 0,
"porcentDescuento": 0.0,
"porcentProntoPago": 0.0,
"porcentRetencion": 0.0,
"porcentRappel": 0.0,
"porcentFinanciacion": 0.0,
"statusWF": 0,
"codigoEmpresa": 1,
"codigoProveedor": "40000001",
"iban": "",
"dc": "",
"ccc": ""
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 1
}Notas:
-Cada proveedor devuelve la ficha completa. Consulte la documentación original para el ejemplo JSON íntegro.
Obtiene la lista de tarifas de descuento dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/tarifa-descuento/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 0,
"totalPages": 0,
"result_list": [],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la lista de tarifas de precios dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/tarifas-precio/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 4,
"totalPages": 4,
"result_list": [
{
"id": {
"codigoEmpresa": 1,
"codigoArticulo": "0000000004",
"tarifa": 1,
"fechaInicio": "24/04/2025"
},
"fechaFinal": "24/04/2025",
"enEuros_": -1,
"statusActivo": 0,
"hastaUnidades1": 0,
"precio1": 1,
"indicadorTarifa": 0,
"desgloseTramos": 0,
"idTarifaPrecio": "8f5c93ec-c944-ce41-b31f-276e01f8fdb1",
"codigoEmpresa": 1,
"codigoArticulo": "0000000004",
"fechaInicio": "2025-04-24",
"tarifa": 1
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la lista de tipos de IVA
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/tipos-iva/find-all
Parámetros requeridos
–
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"codigosRetencion": 2,
"retencion": "string",
"procenRetencion": 2,
"cuentaCargo": "string",
"cuentaAbono": "string",
"claveIrpf": "",
"cuentaCargoANT": "",
"cuentaAbonoANT": "",
"idTipoRetencion": "M"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene los transportistas dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/transportistas/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 3,
"totalPages": 3,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoTransportista": 1 },
"transportista": "DHL",
"codigoRuta_": "02",
"fechaCompra": "20/06/2025",
"proximaRevision": "20/06/2025",
"domicilio": "C/Los Cirios, 1",
"codigoPostal": "4003",
"municipio": "SEGOVIA",
"codigoProvincia": "40",
"provincia": "SEGOVIA",
"codigoNacion": 108,
"nacion": "ESPAÑA",
"telefono": "98547156",
"idTransportista": "db3570a9-2263-dd45-a882-dc84cfa19770",
"siglaNacion": "ES",
"cifDni": "47851269E",
"codigoEmpresa": 1,
"codigoTransportista": 1
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la lista de unidades-medidas dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/unidades-medida/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 0,
"totalPages": 0,
"result_list": [],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene las rutas dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sga_picking/Rutas_/find-by-empresa-page?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoRuta_": "01" },
"idRuta_": "6fa4ef55-8687-ea41-b932-90c6ab95ba6d",
"ruta_": "Ruta predefinida"
},
{
"id": { "codigoEmpresa": 1, "codigoRuta_": "02" },
"idRuta_": "80256599-9d46-5749-88e0-34db5ec23e50",
"ruta_": "Ruta Segovia"
},
{
"id": { "codigoEmpresa": 1, "codigoRuta_": "03" },
"idRuta_": "3d30ca48-a3c7-dc46-a118-b5befd0d30f4",
"ruta_": "Ruta Salamanca"
},
{
"id": { "codigoEmpresa": 1, "codigoRuta_": "04" },
"idRuta_": "90935a8d-d2ac-4747-b553-cb4da17ed7dd",
"ruta_": "Ruta Madrid"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito"
}Obtiene la lista de almacenes dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sgaubicaciones/almacenes/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 6,
"totalPages": 6,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoAlmacen": "000" },
"grupoAlmacen": "",
"responsable": "",
"almacen": "Almacen Principal",
"agruparMovimientos": -1,
"idAlmacen": "6629d571-9803-dc4a-8295-f8cb1c636b58",
"usrCodigoUbicacion": "_DEF",
"usrGestionaUbicaciones": 0,
"usrCodigoUbicacionRecepcion": "",
"usrCodigoUbicacionExpedicion": "PLY EXP",
"codigoAlmacen": "000",
"codigoEmpresa": 1
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Obtiene la lista de artículos dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/sgaubicaciones/articulos/get-all-obsoletoLc/find-by-empresa-page?codigoEmpresa=1&page=0&size=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 9,
"totalPages": 9,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoArticulo": "0000000004" },
"descripcionArticulo": "Fertilizante Nitrofoska 25kg",
"descripcionLinea": "Fertilizante Nitrofoska 25kg",
"codigoAlternativo": "0000000000130",
"tipoArticulo": "M",
"fechaAlta": "24/04/2025",
"codigoFamilia": "02000",
"codigoSubfamilia": "02001",
"codigoDivisa": "EUR",
"grupoIva": 1,
"grupoIvaCompras": 1,
"precioCompra": 0.25,
"precioVenta": 0.34,
"porcentMargen": 37,
"tipoABC": "A",
"idArticulo": "a1797f68-65b5-e542-9704-a22259cdd0a0",
"mesesGarantiaVenta": 24,
"usrPasillo": "01",
"usrFila": "01",
"usrCodigoZonaAlmacen": "01",
"codigoEmpresa": 1,
"codigoArticulo": "0000000004"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Notas:
-Cada artículo devuelve la ficha completa con más de 150 campos. Consulte la documentación original para el ejemplo JSON íntegro.
DUKA (VENTAS)
Actualiza las observaciones de la cabecera de los pedidos de venta
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/ventas/pedido/actualiza-observaciones-cabecera
Parámetros requeridos
Objeto completo de cabecera del pedido de venta (id, codigoCliente, observacionesPedido, importes, etc.). Consulte la documentación original para el cuerpo JSON completo.
Parámetros opcionales
–
Ejemplo de respuesta
Devuelve el mismo objeto de cabecera del pedido de venta actualizado. Consulte la documentación original para el ejemplo JSON completo.
Envía el status de las lecturas de las expediciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/ventas/pedido/cerrar
Parámetros requeridos
{
"id": {
"codigoEmpresa": 1,
"ejercicioPedido": 2026,
"numeroPedido": 1,
"seriePedido": "SF"
},
"statusCerradoExpediciones": -1
}Parámetros opcionales
–
Ejemplo de respuesta
{
"http_status": 201,
"message": "Pedido cerrado: cabecera y lineas actualizadas"
}Envía el status de las lecturas de las expediciones
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/ventas/pedido/cerrar-linea?statusCerradoExpediciones=-1
Parámetros requeridos
Parámetro:statusCerradoExpediciones=-1
{
"id": {
"codigoempresa": 1,
"ejerciciopedido": 2026,
"lineasposicion": "321f79c2-9c2a-4895-bce5-ab37de6b84b9",
"numeropedido": 1,
"orden": 5,
"seriepedido": "ABC"
}
}Parámetros opcionales
–
Ejemplo de respuesta
{
"http_status": 201,
"message": "La linea ha sido cerrada satisfactoriamente"
}Obtiene las expediciones dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/ventas/pedido/get-expediciones_SGA_Picking?codigoEmpresa=1&numeroTerminal=0
Parámetros requeridos
codigoEmpresa
numeroTerminal
Parámetros opcionales
–
Ejemplo de respuesta
Respuesta extensa: devuelve result_list con cabecera del pedido de venta, líneas y lecturas de las expediciones. Consulte la documentación original para el ejemplo JSON completo.
ECOMMERCE (MAESTROS)
Obtiene productos de Sage50.
Ejemplo de petición
http://localhost:8143/Ecommerce/GetArticulos?tarifa=II&tarifa=TD&descontarpedidosventa=true&empresa=01&almacen=00&almacen=01&campoadicategorias=000&campoadisubirinternet=%23%23@&size=3&page=9
Parámetros requeridos
tarifa string[]
descontarpedidosventa bool
empresa string
almacen string[]
campoadicategorias string
campoadisubirinternet string
size int
page int
Parámetros opcionales
–
Ejemplo de respuesta
{
"Items": [
{
"Codigo": "1251001",
"Nombre": "Nike Pegasus 41",
"Observacio": "Después de una carrera, no se recuerda la distancia sino la sensación al correr...",
"Imagenes": [],
"Preciostarifa": [ { "Tarifa": "TD", "Pvp": 0.000000 } ],
"Tyc": [
{ "Talla": "38", "Color": "AZ", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "39", "Color": "AZ", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "40", "Color": "AZ", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "41", "Color": "AZ", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "42", "Color": "AZ", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "43", "Color": "AZ", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "38", "Color": "NE", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "39", "Color": "NE", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "40", "Color": "NE", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "41", "Color": "NE", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "42", "Color": "NE", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "43", "Color": "NE", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] }
],
"Categorias": []
},
{
"Codigo": "7898198",
"Nombre": "Botas nieve cálidas impermeables de senderismo - S",
"Observacio": "Modelo de bota mujer, cálido e impermeable...",
"Imagenes": [],
"Preciostarifa": [ { "Tarifa": "TD", "Pvp": 0.000000 } ],
"Tyc": [
{ "Talla": "37", "Color": "GR", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "38", "Color": "GR", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "39", "Color": "GR", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "40", "Color": "GR", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] },
{ "Talla": "41", "Color": "GR", "Precios": [ { "Tarifa": "TD", "Pvp": 0.000000 } ] }
],
"Categorias": []
},
{
"Codigo": "3454d23",
"Nombre": "CREATINA POLVO 317G",
"Observacio": "Aumentar el rendimiento durante los entrenamientos intensivos y continuados...",
"Imagenes": [],
"Preciostarifa": [ { "Tarifa": "TD", "Pvp": 0.000000 } ],
"Tyc": [],
"Categorias": []
}
],
"Pageable": {
"pageNumber": 9,
"pageSize": 3,
"totalElements": 64,
"totalPages": 22
}
}Obtiene productos de Sage50.
Ejemplo de petición
http://localhost:8143/Ecommerce/Imagen?id=camiseta.jpg
Parámetros requeridos
id
Parámetros opcionales
–
Ejemplo de respuesta
Devuelve la misma estructura de artículos que /Ecommerce/GetArticulos (Items + Pageable). Consulte la documentación original para el ejemplo JSON completo.
INNOBASQUE (ENVIOS)
Crea un cliente en Sage50.
Ejemplo de petición
http://localhost:8143/api/Clientes
Parámetros requeridos
{
"IDCLI": "30",
"NOMBRE": "Paco",
"NOMBRE2": "Gomez",
"CIF": "58432154",
"CODCLI": "43000002",
"DOMICILIO": "domicilio",
"CODPOS": "48902",
"POBLACION": "Leioa",
"PROVINCIA": "bizkaia",
"TELEFONO": "944317956",
"FPAGO": "01",
"NOMBANCO": "nombre del banco",
"IBAN": "ES2114650100722030876293",
"SWIFT": "777"
}Parámetros opcionales
–
Ejemplo de respuesta
{
"IDCLI": "30",
"NOMBRE": "Paco",
"NOMBRE2": "Gomez",
"CIF": "58432154",
"CODCLI": "43000002",
"DOMICILIO": "domicilio",
"CODPOS": "48902",
"POBLACION": "Leioa",
"PROVINCIA": "bizkaia",
"TELEFONO": "944317956",
"FPAGO": "01",
"NOMBANCO": "nombre del banco",
"IBAN": "ES2114650100722030876293",
"SWIFT": "777"
}Crea un contacto en Sage50.
Ejemplo de petición
http://localhost:8143/api/Contactos
Parámetros requeridos
{
"IDCLI":"43015333",
"IDCON":"40",
"NOMBRE":"MARCELO GOMEZ",
"TELEFONO":"619875214",
"EMAIL":"marcelo@empresa.es",
"PUESTO":"responsable",
"CODAUTO": 10
}Parámetros opcionales
–
Ejemplo de respuesta
{
"IDCLI":"43015333",
"IDCON":"40",
"NOMBRE":"MARCELO GOMEZ",
"TELEFONO":"619875214",
"EMAIL":"marcelo@empresa.es",
"PUESTO":"responsable",
"CODAUTO": 10
}Crea una cuota en Sage50.
Ejemplo de petición
http://localhost:8143/api/Cuotas
Parámetros requeridos
{
"IDCLI":"43015333",
"IDCON":"40",
"NOMBRE":"MARCELO GOMEZ",
"TELEFONO":"619875214",
"EMAIL":"marcelo@empresa.es",
"PUESTO":"responsable",
"CODAUTO": 10
}Parámetros opcionales
–
Ejemplo de respuesta
{
"IDCLI":"43015333",
"IDCON":"40",
"NOMBRE":"MARCELO GOMEZ",
"TELEFONO":"619875214",
"EMAIL":"marcelo@empresa.es",
"PUESTO":"responsable",
"CODAUTO": 10
}INNOBASQUE (LOGIN)
Obtiene un token
Ejemplo de petición
http://localhost:8143/api/Autenticacion?Usuario=IBERMATICA&password=1234
Parámetros requeridos
Usuario
password
Parámetros opcionales
–
Ejemplo de respuesta
Credenciales correctas
SILEA (COMPRAS)
Obtiene las facturas de compra
Ejemplo de petición
http://localhost:8143/api/residuos/facturas-compra/filtrar?codigoEmpresa=1&size=1&page=1&defechaModficacion='16/12/2025'&token='2de63afe-669d-40ed-9d9d-f600a4172aad'
Parámetros requeridos
codigoEmpresa
page
size
fechaModificacion
Parámetros opcionales
–
Ejemplo de respuesta
{
"content": [
{
"id": {
"codigoEmpresa": 1,
"ejercicioFactura": 2025,
"serieFactura": "",
"numeroFactura": " 1"
},
"codigoProveedor": "40000001",
"fechaFactura": "2025-01-12T00:00:00",
"fechaCreacion": "2025-10-27T12:33:42",
"formadePago": "01",
"importeNetoLineas": 0,
"importeLiquido": 0,
"SyncInfo": {
"Traspasar": false,
"FechaModificacion": "2026-02-09T09:10:43",
"idProcesoExportacion": "2168F2E2-F197-4A99-AA38-C16017CFA413 ",
"idRegistro": "2168F2E2-F197-4A99-AA38-C16017CFA413 ",
"estadoExterno": null,
"recibidoCorrectamente": false
},
"lineas": [
{
"id": {
"codigoEmpresa": "01",
"ejercicioAlbaran": 2025,
"serieAlbaran": "40000001",
"numeroAlbaran": "1",
"orden": "1",
"lineasPosicion": "025D4978-5AAB-45A6-976D-3A29C35999E5"
},
"SyncInfo": { "Traspasar": false, "FechaModificacion": "2026-02-09T09:10:43" }
}
],
"ivaResumenes": [
{
"id": {
"codigoEmpresa": "01",
"ejercicioFactura": 2025,
"serieFactura": "",
"numeroFactura": " 1",
"grupoIva": 0,
"codigoIva": "03",
"codigoTransaccion": 0
},
"cuentaRecargo": "47700021",
"cuentaIvaRepercutido": "47700026",
"iva": 21.00,
"baseImponible": 200.0000,
"cuotaIva": 42.0000,
"totalIva": 42.0000
}
]
}
],
"pageable": {
"sort": [ { "empty": true, "unsorted": true, "sorted": false } ],
"offset": 0,
"pageSize": 4,
"pageNumber": 0,
"unpaged": false,
"paged": true
},
"last": false,
"totalPages": 1,
"totalElements": 2,
"size": 4,
"number": 1,
"numberOfElements": 1,
"first": true,
"empty": false
}Notas:
-La respuesta original incluye varias facturas con sus líneas e ivaResumenes. Consulte la documentación original para el ejemplo JSON completo.
SILEA (MAESTROS)
Obtiene los datos de formas de pago dado su código de empresa
Ejemplo de petición
http://localhost:8143/multinnector_sga/sage/maestros/formas-pago/find-by-empresa?codigoEmpresa=1
Parámetros requeridos
codigoEmpresa
page
size
Parámetros opcionales
–
Ejemplo de respuesta
{
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoCondiciones": 1 },
"condiciones": "CONTADO",
"formadePago": "CONTADO",
"codigoTipoEfecto": "01",
"numeroPlazos": 1,
"diasPrimerPlazo": 0,
"diasEntrePlazos": 0,
"controlarFestivos": 0
},
{
"id": { "codigoEmpresa": 1, "codigoCondiciones": 1 },
"condiciones": "0,30",
"formadePago": "0,30",
"codigoTipoEfecto": "30",
"numeroPlazos": 2,
"diasPrimerPlazo": 0,
"diasEntrePlazos": 0,
"controlarFestivos": 0
}
]
}Obtiene la lista de artículos dado su código de empresa
Ejemplo de petición
http://localhost:8143/silea/articulos/find-by-empresa-page?codigoEmpresa=1&page=0&size=1&CampoAdiFiltro=001
Parámetros requeridos
codigoEmpresa
page
size
CampoAdiFiltro
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 9,
"totalPages": 9,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoArticulo": "0000000004" },
"descripcionArticulo": "Fertilizante Nitrofoska 25kg",
"descripcionLinea": "Fertilizante Nitrofoska 25kg",
"codigoAlternativo": "0000000000130",
"tipoArticulo": "M",
"fechaAlta": "24/04/2025",
"codigoFamilia": "02000",
"codigoSubfamilia": "02001",
"codigoDivisa": "EUR",
"grupoIva": 1,
"grupoIvaCompras": 1,
"precioCompra": 0.25,
"precioVenta": 0.34,
"porcentMargen": 37,
"tipoABC": "A",
"idArticulo": "a1797f68-65b5-e542-9704-a22259cdd0a0",
"mesesGarantiaVenta": 24,
"usrPasillo": "01",
"usrFila": "01",
"usrCodigoZonaAlmacen": "01",
"codigoEmpresa": 1,
"codigoArticulo": "0000000004"
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 0
}Notas:
-CampoAdiFiltro: Se debe informar con el código del campo adicional de Sage50 de tipo lógico que filtrará si el artículo se recoge o no. Si no se informa se cargarán todos; si no, sólo los que tengan un valor verdadero en el campo adicional.
Obtiene los datos de un cliente dado su código de empresa
Ejemplo de petición
http://localhost:8143/silea/clientes/find-by-empresa-and-bajaempresa-page?codigoEmpresa=1&page=0&size=10&CampoAdiFiltro=001
Parámetros requeridos
codigoEmpresa
page
size
CampoAdiFiltro
Parámetros opcionales
–
Ejemplo de respuesta
{
"content": [
{
"id": { "codigoEmpresa": 1, "codigoCliente": "43000001" },
"siglaNacion": "ES",
"fechaAlta": "17/10/2025",
"codigoContable": "43000001",
"codigoDivisa": "000",
"razonSocial": "CLIENTE CONTADO",
"nombre": "CLIENTE CONTADO",
"nacion": "España",
"idCliente": "8DC11063-508F-44B0-9B6F-C6228A0D8AB1 ",
"codigoCliente": "43000001",
"codigoEmpresa": 1,
"codigoRetencion": "",
"cliFactura": ""
}
],
"pageable": {
"sort": { "empty": true, "sorted": false, "unsorted": true },
"offset": 0,
"pageNumber": 1,
"pageSize": 10,
"paged": true,
"unpaged": false
},
"totalElements": 1,
"totalPages": 1,
"last": false,
"size": 10,
"number": 0,
"numberOfElements": 1,
"first": true,
"empty": false
}Notas:
-CampoAdiFiltro: Se debe informar con el código del campo adicional de Sage50 de tipo lógico que filtrará si el cliente se recoge o no. Si no se informa se cargarán todos; si no, sólo los que tengan un valor verdadero en el campo adicional.
Obtiene la lista de proveedores dado su código de empresa
Ejemplo de petición
http://localhost:8143/silea/proveedores/find-by-empresa-page?codigoEmpresa=1&page=0&size=10&CampoAdiFiltro=001
Parámetros requeridos
codigoEmpresa
page
size
CampoAdiFiltro
Parámetros opcionales
–
Ejemplo de respuesta
{
"totalItems": 1,
"totalPages": 1,
"result_list": [
{
"id": { "codigoEmpresa": 1, "codigoProveedor": "40000001" },
"razonSocial": "PROVEEDOR",
"codigoContable": "40000001",
"codigoCondiciones": 0,
"codigoPostal": " ",
"codigoNacion": 0,
"porcentDescuento": 0.00,
"statusWF": 0,
"codigoEmpresa": 1,
"codigoProveedor": "40000001",
"iban": "",
"dc": "",
"ccc": "",
"codigoRetencion": ""
}
],
"http_status": 200,
"message": "Consulta realizada con éxito",
"currentPage": 1
}Notas:
-CampoAdiFiltro: Se debe informar con el código del campo adicional de Sage50 de tipo lógico que filtrará si el proveedor se recoge o no. Si no se informa se cargarán todos; si no, sólo los que tengan un valor verdadero en el campo adicional.
SILEA (VENTAS)
Obtiene las facturas de venta
Ejemplo de petición
http://localhost:8143/api/residuos/facturas-venta/filtrar?codigoEmpresa=1&size=1&page=1&defechaModficacion='16/12/2025'&token='2de63afe-669d-40ed-9d9d-f600a4172aad'
Parámetros requeridos
codigoEmpresa
page
size
fechaModificacion
Parámetros opcionales
–
Ejemplo de respuesta
{
"content": [
{
"id": { "codigoEmpresa": 99, "ejercicioFactura": 2025, "serieFactura": "01", "numeroFactura": 1 },
"codigoCliente": "4300009879",
"fechaFactura": "09/06/2025",
"fechaCreacion": "09/06/2025",
"formadePago": "PAGARÉ A 60 DÍAS",
"porcentDescuento": 5,
"porcentProntoPago": 10,
"porcentRetencion": 15,
"importeDescuento": 8.55,
"importeProntoPago": 16.25,
"importeRetencion": 21.93,
"importeNetoLineas": 171,
"importeLiquido": 151.75,
"syncInfo": {
"traspasar": false,
"fechaModificacion": "2025-06-09T12:12:23.177+02:00",
"idProcesoExportacion": "d73e463c-e85c-42d6-8f33-5eede6289dfc",
"idRegistro": "395befb4-f6ff-4134-9da6-b8ae185c0fb1",
"estadoExterno": null,
"recibidoCorrectamente": false
},
"lineas": [
{
"id": { "codigoEmpresa": 99, "ejercicioAlbaran": 2025, "serieAlbaran": "01", "numeroAlbaran": 57, "orden": 0, "lineasPosicion": "a42ec1b0-b4d2-004a-9e43-059841679287" },
"ael_ejercicioAlbaranSilea": "", "ael_serieAlbaranSilea": "", "ael_numeroAlbaranSilea": ""
},
{
"id": { "codigoEmpresa": 99, "ejercicioAlbaran": 2025, "serieAlbaran": "01", "numeroAlbaran": 57, "orden": 0, "lineasPosicion": "aa90eace-0e23-7b44-aab6-695263adac28" },
"ael_ejercicioAlbaranSilea": "", "ael_serieAlbaranSilea": "", "ael_numeroAlbaranSilea": ""
}
],
"ivaResumenes": [
{
"id": { "codigoEmpresa": 99, "ejercicioFactura": 2025, "serieFactura": "01", "numeroFactura": 1, "grupoIva": 2, "codigoIva": 11, "codigoTransaccion": 1 },
"iva": 10, "recargo": 1.4, "baseImponible": 73.1, "cuotaIva": 7.31, "cuotaRecargo": 1.02, "totalIva": 8.33
},
{
"id": { "codigoEmpresa": 99, "ejercicioFactura": 2025, "serieFactura": "01", "numeroFactura": 1, "grupoIva": 1, "codigoIva": 26, "codigoTransaccion": 1 },
"iva": 21, "recargo": 5.2, "baseImponible": 73.1, "cuotaIva": 15.35, "cuotaRecargo": 3.8, "totalIva": 19.15
}
],
"iban": "", "dc": "", "ccc": ""
}
],
"pageable": {
"sort": { "empty": true, "unsorted": true, "sorted": false },
"offset": 0, "pageSize": 1, "pageNumber": 0, "unpaged": false, "paged": true
},
"last": false, "totalPages": 5, "totalElements": 5, "size": 1, "number": 0,
"numberOfElements": 1, "first": true, "empty": false
}