3.7 KiB
3.7 KiB
API — Datos de Cocinas Modulares (MARMOTECH)
Servicio REST para consultar, por período, las ventas, gastos y consumo de insumos de las cocinas modulares.
Conexión
| URL | https://ws.marmotech.com.do/gas/ws/r/restserver |
| Método | POST |
| Header | Content-Type: dbsync/json |
| Header | DBSync-Client: mbs |
Ambos headers son obligatorios. Si
DBSync-Clientno es exactamentembso elContent-Typeno empieza condbsync/json, el servidor responde400 Bad request.
Cuerpo del request (body)
El body es un JSON con dos campos: oper y data.
Importante: data NO es un objeto — es un string que contiene otro JSON
(por eso sus comillas van escapadas con \).
{
"oper": "datos_cocinas",
"data": "{\"usuario\":\"conecta\",\"clave\":\"conecta\",\"fechaCorte\":\"2026-07-01\"}"
}
Parámetros dentro de data
| Campo | Tipo | Descripción |
|---|---|---|
usuario |
string | Usuario de base de datos para la conexión. |
clave |
string | Clave del usuario. |
fechaCorte |
string YYYY-MM-DD |
Cualquier fecha dentro del mes de producción a consultar. El servicio toma el año/mes de esta fecha para calcular el rango (fecha1–fecha2). |
Ejemplos por herramienta
curl — Linux / Mac / Git Bash
curl -i -X POST "https://ws.marmotech.com.do/gas/ws/r/restserver" \
-H "Content-Type: dbsync/json" \
-H "DBSync-Client: mbs" \
-d '{"oper":"datos_cocinas","data":"{\"usuario\":\"conecta\",\"clave\":\"conecta\",\"fechaCorte\":\"2026-07-01\"}"}'
curl — Windows CMD (cmd.exe)
curl.exe -i -X POST "https://ws.marmotech.com.do/gas/ws/r/restserver" -H "Content-Type: dbsync/json" -H "DBSync-Client: mbs" -d "{\"oper\":\"datos_cocinas\",\"data\":\"{\\\"usuario\\\":\\\"conecta\\\",\\\"clave\\\":\\\"conecta\\\",\\\"fechaCorte\\\":\\\"2026-07-01\\\"}\"}"
Windows PowerShell (recomendado en Windows)
PowerShell maltrata las comillas al pasarlas a curl.exe; usa Invoke-RestMethod:
$body = @'
{"oper":"datos_cocinas","data":"{\"usuario\":\"conecta\",\"clave\":\"conecta\",\"fechaCorte\":\"2026-07-01\"}"}
'@
Invoke-RestMethod -Uri "https://ws.marmotech.com.do/gas/ws/r/restserver" `
-Method Post -ContentType "dbsync/json" `
-Headers @{ "DBSync-Client" = "mbs" } -Body $body
Postman
- Método POST, URL
https://ws.marmotech.com.do/gas/ws/r/restserver - Pestaña Headers: agregar
Content-Type: dbsync/jsonyDBSync-Client: mbs - Pestaña Body → raw → pegar el JSON de la sección Cuerpo del request.
Respuesta
HTTP/1.1 200 OK con Content-Type: dbsync/json. El cuerpo es un JSON:
{
"ventasCantidad": 99,
"cantidadInsumos": 3568.904,
"ventasVAlor": 2347966.48,
"gastos": 128799.65,
"valorIsumos": 794649.12,
"cod_msg": 200,
"descripcion": "OPERACION EXITOSA"
}
| Campo | Descripción |
|---|---|
ventasCantidad |
Unidades vendidas de cocinas modulares en el período. |
ventasVAlor |
Ventas netas (bruto − descuento) de las facturas de cocinas. |
gastos |
Gastos del departamento de Ensamble Modulares (6118) en el período. |
cantidadInsumos |
Cantidad de insumos consumidos en el período. |
valorIsumos |
Valor de esos insumos al costo estándar. |
cod_msg |
200 = OK. 400 = error (ver descripcion). |
descripcion |
Mensaje del resultado. Ej.: OPERACION EXITOSA, USUARIO NO VALIDO. |
Errores comunes
| Situación | Respuesta |
|---|---|
| Usuario/clave de BD inválidos | cod_msg: 400, descripcion: "USUARIO NO VALIDO ..." |
Header DBSync-Client o Content-Type incorrecto |
HTTP 400 Bad request |
data con JSON mal escapado |
Error de parseo JSON (-8109) — revisar el escape de comillas |