Addresses
getAddresses
Obtiene una lista de direcciones dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/addresses
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
Identificadores ERP
client_ids
Identificadores del cliente
erp_client_ids
Identificadores ERP del cliente
remote_id
Remote identifier
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/addresses?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"erp_ids": ["DIR-001", "DIR-002"],
"client_ids": [1, 2]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/addresses`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"erp_ids": ["DIR-001", "DIR-002"],
"client_ids": [1, 2]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/addresses"
r = requests.get(url, json={
'ids': [1, 2],
'erp_ids': ['DIR-001', 'DIR-002'],
'client_ids': [1, 2]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/addresses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'erp_ids': ['DIR-001', 'DIR-002'],
'client_ids': [1, 2]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "DIR-001",
"name": "Sede Central",
"zip_code": "28001",
"city": "Madrid"
}
],
"page": 0,
"total": 1
}
postAddresses
POSThttps://{company}.gmao.cloud/apigmao/{token}/addresses
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of addresses to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/addresses' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "DIR-001",
"name": "Sede Central",
"address": "Calle Gran Vía 1"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/addresses`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "DIR-001",
"name": "Sede Central",
"address": "Calle Gran Vía 1"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/addresses"
r = requests.post(url, json={
'list': [
{
'erp_id': 'DIR-001',
'name': 'Sede Central',
'address': 'Calle Gran Vía 1'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/addresses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'DIR-001',
'name': 'Sede Central',
'address': 'Calle Gran Vía 1'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Direcciones actualizadas correctamente"
}
deleteAddresses
Elimina direcciones por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/addresses
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 409 | La dirección, o alguno de sus sistemas o activos, está en uso (OTs, incidencias, mantenimientos, obras o presupuestos); no se borra nada. El mensaje indica qué lo bloquea |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/addresses' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["DIR-001", "DIR-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/addresses`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["DIR-001", "DIR-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/addresses"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['DIR-001', 'DIR-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/addresses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['DIR-001', 'DIR-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Direcciones eliminadas correctamente"
}
Assets
getAssets
Obtiene una lista de activos dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/assets
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
Identificadores ERP
facility_id
Identificador de sistema
facility_erp_id
Identificador ERP de sistema
remote_id
Remote identifier
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/assets?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1],
"erp_ids": ["value"],
"facility_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/assets`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1],
"erp_ids": ["value"],
"facility_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/assets"
r = requests.get(url, json={
'ids': [1],
'erp_ids': ['value'],
'facility_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/assets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1],
'erp_ids': ['value'],
'facility_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"id": 1,
"erp_id": "erp_id",
"serial_number": "serial_number",
"installation_date": "installation_date",
"end_of_warranty": "end_of_warranty"
}
postAssets
POSThttps://{company}.gmao.cloud/apigmao/{token}/assets
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of assets to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/assets' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "ACT-001",
"name": "Compresor Industrial",
"brand": "Atlas Copco"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/assets`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "ACT-001",
"name": "Compresor Industrial",
"brand": "Atlas Copco"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/assets"
r = requests.post(url, json={
'list': [
{
'erp_id': 'ACT-001',
'name': 'Compresor Industrial',
'brand': 'Atlas Copco'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/assets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'ACT-001',
'name': 'Compresor Industrial',
'brand': 'Atlas Copco'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Activos actualizados correctamente"
}
deleteAssets
Elimina activos por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/assets
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 409 | El activo está en uso (OTs, incidencias, mantenimientos o presupuestos); no se borra nada. El mensaje indica qué lo bloquea |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/assets' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["ACT-001", "ACT-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/assets`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["ACT-001", "ACT-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/assets"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['ACT-001', 'ACT-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/assets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['ACT-001', 'ACT-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Activos eliminados correctamente"
}
Budgets
postBudgetLine
Create or update budget lines. Send a list of line objects.
POSThttps://{company}.gmao.cloud/apigmao/{token}/budgetLine
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of budget-line to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgetLine' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"line_id": 100,
"budget_offer_id": 10,
"budget_offer_erp_id": "OFFER-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgetLine`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"line_id": 100,
"budget_offer_id": 10,
"budget_offer_erp_id": "OFFER-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgetLine"
r = requests.post(url, json={
'list': [
{
'line_id': 100,
'budget_offer_id': 10,
'budget_offer_erp_id': 'OFFER-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgetLine");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'line_id': 100,
'budget_offer_id': 10,
'budget_offer_erp_id': 'OFFER-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
deleteBudgetLine
Soft-delete a budget line.
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/budgetLine
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
id
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgetLine' \
-H "Content-Type: application/json" \
-d '{
"id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgetLine`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgetLine"
r = requests.delete(url, json={
'id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgetLine");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
postBudgetOffer
Create or update budget offers. Send a list of offer objects.
POSThttps://{company}.gmao.cloud/apigmao/{token}/budgetOffer
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of budget-offer to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgetOffer' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "OFFER-001",
"budget_id": 1,
"budget_erp_id": "PRES-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgetOffer`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "OFFER-001",
"budget_id": 1,
"budget_erp_id": "PRES-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgetOffer"
r = requests.post(url, json={
'list': [
{
'erp_id': 'OFFER-001',
'budget_id': 1,
'budget_erp_id': 'PRES-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgetOffer");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'OFFER-001',
'budget_id': 1,
'budget_erp_id': 'PRES-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
deleteBudgetOffer
Soft-delete a budget offer. Rejects accepted offers.
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/budgetOffer
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
id
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgetOffer' \
-H "Content-Type: application/json" \
-d '{
"id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgetOffer`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgetOffer"
r = requests.delete(url, json={
'id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgetOffer");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
getBudgets
Returns a paginated list of budgets with blocks, lines, totals, and status history
GEThttps://{company}.gmao.cloud/apigmao/{token}/budgets
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
erp_ids
project_id
subcontractor_ids
project_erp_id
client_id
client_erp_id
billing_client_id
billing_client_erp_id
address_id
address_erp_id
client_ref
date
date_from
date_to
status
incident_id
Filter by incident ID
work_order_id
Filter by origin work order ID
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgets?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"erp_ids": ["PRES-001"],
"project_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgets`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"erp_ids": ["PRES-001"],
"project_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgets"
r = requests.get(url, json={
'ids': [1, 2],
'erp_ids': ['PRES-001'],
'project_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'erp_ids': ['PRES-001'],
'project_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"id": 1,
"erp_id": "PRES-001",
"code": "ES2501-001",
"title": "Annual maintenance budget",
"date": "2024-01-15"
}
postBudgets
Create or update budgets. Send a list of budget objects. Partial update when a record exists.
POSThttps://{company}.gmao.cloud/apigmao/{token}/budgets
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of budgets to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgets' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "PRES-001",
"id": 1,
"title": "Maintenance budget"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgets`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "PRES-001",
"id": 1,
"title": "Maintenance budget"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgets"
r = requests.post(url, json={
'list': [
{
'erp_id': 'PRES-001',
'id': 1,
'title': 'Maintenance budget'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'PRES-001',
'id': 1,
'title': 'Maintenance budget'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
deleteBudgets
Soft-delete a budget with cascading delete of its offers and lines. Rejects budgets with generated work orders.
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/budgets
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
id
erp_id
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgets' \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"erp_id": "PRES-001"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgets`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1,
"erp_id": "PRES-001"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgets"
r = requests.delete(url, json={
'id': 1,
'erp_id': 'PRES-001'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'id': 1,
'erp_id': 'PRES-001'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
postBudgetState
Change the status of budgets, blocks, or offers. Send a list of state change objects.
POSThttps://{company}.gmao.cloud/apigmao/{token}/budgetState
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of budget-state to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/budgetState' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"budget_id": 1,
"state_id": 2,
"state_erp_id": "EST-PRES-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/budgetState`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"budget_id": 1,
"state_id": 2,
"state_erp_id": "EST-PRES-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/budgetState"
r = requests.post(url, json={
'list': [
{
'budget_id': 1,
'state_id': 2,
'state_erp_id': 'EST-PRES-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/budgetState");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'budget_id': 1,
'state_id': 2,
'state_erp_id': 'EST-PRES-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
// No response body
Clients
getClients
Obtiene una lista de clientes dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/clients
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
erp_id
Identificador ERP
remote_id
Remote identifier
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/clients?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_id": "CLI-001",
"remote_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/clients`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_id": "CLI-001",
"remote_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/clients"
r = requests.get(url, json={
'ids': [1, 2, 3],
'erp_id': 'CLI-001',
'remote_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/clients");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_id': 'CLI-001',
'remote_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "CLI-001",
"name": "Empresa Ejemplo S.L.",
"trade_name": "Ejemplo",
"email": "contacto@ejemplo.com",
"phone": "+34 91 123 4567"
}
],
"page": 0,
"total": 1
}
postClients
POSThttps://{company}.gmao.cloud/apigmao/{token}/clients
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of clients to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/clients' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "CLI-001",
"name": "Empresa Ejemplo S.L.",
"trade_name": "Ejemplo"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/clients`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "CLI-001",
"name": "Empresa Ejemplo S.L.",
"trade_name": "Ejemplo"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/clients"
r = requests.post(url, json={
'list': [
{
'erp_id': 'CLI-001',
'name': 'Empresa Ejemplo S.L.',
'trade_name': 'Ejemplo'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/clients");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'CLI-001',
'name': 'Empresa Ejemplo S.L.',
'trade_name': 'Ejemplo'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Clientes actualizados correctamente"
}
deleteClients
Elimina clientes por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/clients
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 409 | Cliente o sus usuarios están en uso por otros registros (OTs, incidencias, mantenimientos, obras o presupuestos); no se borra nada. El mensaje indica qué lo bloquea |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/clients' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["CLI-001", "CLI-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/clients`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["CLI-001", "CLI-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/clients"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['CLI-001', 'CLI-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/clients");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['CLI-001', 'CLI-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Clientes eliminados correctamente"
}
Report expenses and bonuses
getExpensesAndBonuses
Obtiene datos del informe de gastos y pluses. Cada linea incluye comments (observaciones de la linea de horas, descripcion en los gastos; sustituye a coments, que ya no se devuelve) y validations (una por grupo validador; [] si el modulo de validaciones esta inactivo o la linea no tiene). Cada validacion lleva group, result (PENDING, ACCEPTED o REJECTED), answered_at y validator (id, full_name y erp_id; null mientras nadie haya respondido).
GEThttps://{company}.gmao.cloud/apigmao/{token}/expensesAndBonuses
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
project_code
Project code
project_erp_id
Project ERP identifier
project_id
Project identifier
team_name
Team name
team_id
Team identifier
status
Export status
date_from
Date from
date_to
Date to
wo_ids
Work orders identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/expensesAndBonuses?page=0' \
-H "Content-Type: application/json" \
-d '{
"project_code": "PRJ-2024",
"project_erp_id": "PROJ-001",
"project_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/expensesAndBonuses`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"project_code": "PRJ-2024",
"project_erp_id": "PROJ-001",
"project_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/expensesAndBonuses"
r = requests.get(url, json={
'project_code': 'PRJ-2024',
'project_erp_id': 'PROJ-001',
'project_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/expensesAndBonuses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'project_code': 'PRJ-2024',
'project_erp_id': 'PROJ-001',
'project_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"id": 1,
"technician": "value",
"date": "2024-01-15T08:00:00",
"exported_at": "2024-01-16T10:30:00",
"project_code": "PRJ-2024"
}
postExpensesAndBonuses
Actualiza la fecha de exportación de las lineas
POSThttps://{company}.gmao.cloud/apigmao/{token}/expensesAndBonuses
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of expenses-and-bonuses to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/expensesAndBonuses' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"id": 1,
"group": "wo_hours"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/expensesAndBonuses`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"id": 1,
"group": "wo_hours"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/expensesAndBonuses"
r = requests.post(url, json={
'list': [
{
'id': 1,
'group': 'wo_hours'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/expensesAndBonuses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'id': 1,
'group': 'wo_hours'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Lineas actualizadas correctamente"
}
Expenses and bonuses
deleteExpensesAndBonuses
Elimina gastos y bonificaciones por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/expensesAndBonuses
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/expensesAndBonuses' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["GB-001", "GB-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/expensesAndBonuses`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["GB-001", "GB-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/expensesAndBonuses"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['GB-001', 'GB-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/expensesAndBonuses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['GB-001', 'GB-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Gastos y bonificaciones eliminados correctamente"
}
Facilities
getFacilities
Obtiene una lista de sistemas dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/facilities
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
Identificadores ERP
address_erp_ids
Identificadores ERP de direcciones
address_ids
Identificadores de direcciones
parent_erp_ids
Identificadores ERP de sistemas padre
parent_ids
Identificadores de sistemas padre
remote_id
Remote identifier
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/facilities?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1],
"erp_ids": [1],
"address_erp_ids": ["value"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/facilities`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1],
"erp_ids": [1],
"address_erp_ids": ["value"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/facilities"
r = requests.get(url, json={
'ids': [1],
'erp_ids': [1],
'address_erp_ids': ['value']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/facilities");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1],
'erp_ids': [1],
'address_erp_ids': ['value']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"id": 1,
"erp_id": "erp_id",
"name": "name",
"level": 1,
"remote_id": 1
}
postFacilities
POSThttps://{company}.gmao.cloud/apigmao/{token}/facilities
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of facilities to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/facilities' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "SIS-001",
"name": "Sistema HVAC Planta 1",
"remote_id": 1
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/facilities`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "SIS-001",
"name": "Sistema HVAC Planta 1",
"remote_id": 1
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/facilities"
r = requests.post(url, json={
'list': [
{
'erp_id': 'SIS-001',
'name': 'Sistema HVAC Planta 1',
'remote_id': 1
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/facilities");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'SIS-001',
'name': 'Sistema HVAC Planta 1',
'remote_id': 1
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Sistemas actualizados correctamente"
}
deleteFacilities
Elimina sistemas por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/facilities
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 409 | El sistema, sus subsistemas o sus activos están en uso (OTs, incidencias, mantenimientos o presupuestos); no se borra nada. El mensaje indica qué lo bloquea |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/facilities' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["SIS-001", "SIS-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/facilities`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["SIS-001", "SIS-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/facilities"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['SIS-001', 'SIS-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/facilities");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['SIS-001', 'SIS-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Sistemas eliminados correctamente"
}
Incident states
getIncidentStates
Obtiene una lista de estados de incidencia según los filtros aplicados
GEThttps://{company}.gmao.cloud/apigmao/{token}/incidentStates
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number
Body filters
Content-Type: application/json
ids
Internal identifiers
erp_ids
ERP identifiers
status_flag
Filter by behaviour flag
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidentStates?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"erp_ids": ["EST-INC-001"],
"status_flag": "DEFAULT"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidentStates`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"erp_ids": ["EST-INC-001"],
"status_flag": "DEFAULT"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidentStates"
r = requests.get(url, json={
'ids': [1, 2],
'erp_ids': ['EST-INC-001'],
'status_flag': 'DEFAULT'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidentStates");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'erp_ids': ['EST-INC-001'],
'status_flag': 'DEFAULT'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "EST-INC-001",
"name": "Abierta",
"visible": true,
"visible_client": true,
"max_time": 86400
}
],
"page": 0,
"total": 1
}
postIncidentStates
Crea o actualiza estados de incidencia. Si se pasan id y erp_id, id selecciona el registro y erp_id se actualiza.
POSThttps://{company}.gmao.cloud/apigmao/{token}/incidentStates
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of incident-states to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidentStates' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"name": "Abierta",
"id": 3,
"erp_id": "EST-INC-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidentStates`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"name": "Abierta",
"id": 3,
"erp_id": "EST-INC-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidentStates"
r = requests.post(url, json={
'list': [
{
'name': 'Abierta',
'id': 3,
'erp_id': 'EST-INC-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidentStates");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'name': 'Abierta',
'id': 3,
'erp_id': 'EST-INC-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Estados de incidencia actualizados correctamente"
}
deleteIncidentStates
Elimina estados de incidencia por ID interno o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/incidentStates
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Internal identifiers
erp_ids
ERP identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidentStates' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["EST-INC-001", "EST-INC-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidentStates`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["EST-INC-001", "EST-INC-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidentStates"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['EST-INC-001', 'EST-INC-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidentStates");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['EST-INC-001', 'EST-INC-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Estados de incidencia eliminados correctamente"
}
Incident types
getIncidentTypes
Obtiene una lista de tipos de incidencia según los filtros aplicados
GEThttps://{company}.gmao.cloud/apigmao/{token}/incidentTypes
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number
Body filters
Content-Type: application/json
ids
Internal identifiers
erp_ids
ERP identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidentTypes?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"erp_ids": ["TIP-INC-001"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidentTypes`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"erp_ids": ["TIP-INC-001"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidentTypes"
r = requests.get(url, json={
'ids': [1, 2],
'erp_ids': ['TIP-INC-001']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidentTypes");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'erp_ids': ['TIP-INC-001']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "TIP-INC-001",
"name": "Correctivo",
"code": "COR"
}
],
"page": 0,
"total": 1
}
postIncidentTypes
Crea o actualiza tipos de incidencia. Si se pasan id y erp_id, id selecciona el registro y erp_id se actualiza.
POSThttps://{company}.gmao.cloud/apigmao/{token}/incidentTypes
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of incident-types to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidentTypes' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"name": "Correctivo",
"id": 1,
"erp_id": "TIP-INC-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidentTypes`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"name": "Correctivo",
"id": 1,
"erp_id": "TIP-INC-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidentTypes"
r = requests.post(url, json={
'list': [
{
'name': 'Correctivo',
'id': 1,
'erp_id': 'TIP-INC-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidentTypes");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'name': 'Correctivo',
'id': 1,
'erp_id': 'TIP-INC-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Tipos de incidencia actualizados correctamente"
}
deleteIncidentTypes
Elimina tipos de incidencia por ID interno o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/incidentTypes
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Internal identifiers
erp_ids
ERP identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidentTypes' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["TIP-INC-001", "TIP-INC-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidentTypes`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["TIP-INC-001", "TIP-INC-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidentTypes"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['TIP-INC-001', 'TIP-INC-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidentTypes");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['TIP-INC-001', 'TIP-INC-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Tipos de incidencia eliminados correctamente"
}
Incidents
getIncidents
Obtiene una lista de incidencias según los filtros aplicados
GEThttps://{company}.gmao.cloud/apigmao/{token}/incidents
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number
Body filters
Content-Type: application/json
ids
Internal identifiers
erp_ids
ERP identifiers
address_id
Address identifier
customer_id
Customer identifier
system_id
System identifier
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidents?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"erp_ids": ["INC-001"],
"address_id": 10
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidents`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"erp_ids": ["INC-001"],
"address_id": 10
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidents"
r = requests.get(url, json={
'ids': [1, 2],
'erp_ids': ['INC-001'],
'address_id': 10
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidents");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'erp_ids': ['INC-001'],
'address_id': 10
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "INC-001",
"description": "Fuga de agua",
"priority": 5,
"warranty": false,
"observations": "Revisar urgente"
}
],
"page": 0,
"total": 1
}
postIncidents
Crea o actualiza incidencias. Si se pasan id y erp_id, id selecciona el registro y erp_id se actualiza.
POSThttps://{company}.gmao.cloud/apigmao/{token}/incidents
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of incidents to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidents' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"description": "Fuga de agua",
"id": 42,
"erp_id": "INC-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidents`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"description": "Fuga de agua",
"id": 42,
"erp_id": "INC-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidents"
r = requests.post(url, json={
'list': [
{
'description': 'Fuga de agua',
'id': 42,
'erp_id': 'INC-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidents");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'description': 'Fuga de agua',
'id': 42,
'erp_id': 'INC-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Incidencias actualizadas correctamente"
}
deleteIncidents
Elimina incidencias por ID interno o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/incidents
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Internal identifiers
erp_ids
ERP identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 400 | Bad request. |
| 404 | No records found. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/incidents' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["INC-001", "INC-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/incidents`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["INC-001", "INC-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/incidents"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['INC-001', 'INC-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/incidents");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['INC-001', 'INC-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Incidencias eliminadas correctamente"
}
Items
getItems
Obtiene una lista de artículos dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/items
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
id
Identifier
erp_id
Identificador ERP
reference
Referencia del artículo
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/items?page=0' \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"erp_id": "ART-001",
"reference": "REF-001"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/items`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1,
"erp_id": "ART-001",
"reference": "REF-001"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/items"
r = requests.get(url, json={
'id': 1,
'erp_id': 'ART-001',
'reference': 'REF-001'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/items");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'id': 1,
'erp_id': 'ART-001',
'reference': 'REF-001'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "ART-001",
"reference": "REF-001",
"description": "Tornillo M6 acero inoxidable",
"price": 1.5,
"cost": 0.8
}
],
"page": 0,
"total": 1
}
postItems
POSThttps://{company}.gmao.cloud/apigmao/{token}/items
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of items to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/items' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "ART-001",
"reference": "REF-001",
"description": "Tornillo M6"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/items`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "ART-001",
"reference": "REF-001",
"description": "Tornillo M6"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/items"
r = requests.post(url, json={
'list': [
{
'erp_id': 'ART-001',
'reference': 'REF-001',
'description': 'Tornillo M6'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/items");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'ART-001',
'reference': 'REF-001',
'description': 'Tornillo M6'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Artículos actualizados correctamente"
}
deleteItems
Elimina artículos por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/items
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/items' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["ART-001", "ART-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/items`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["ART-001", "ART-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/items"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['ART-001', 'ART-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/items");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['ART-001', 'ART-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Artículos eliminados correctamente"
}
Projects
getProjects
Obtiene una lista de projectos dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/projects
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
project_code
Project code
erp_id
Identificador ERP
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/projects?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1],
"project_code": "project_code",
"erp_id": "erp_id"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/projects`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1],
"project_code": "project_code",
"erp_id": "erp_id"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/projects"
r = requests.get(url, json={
'ids': [1],
'project_code': 'project_code',
'erp_id': 'erp_id'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/projects");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1],
'project_code': 'project_code',
'erp_id': 'erp_id'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"id": 1,
"project_code": "project_code",
"title": "title",
"current_state": "current_state",
"erp_id": "erp_id"
}
postProjects
Actualiza los proyectos en la base de datos. Si el proyecto no existe, lo crea. Si existe, lo actualiza
POSThttps://{company}.gmao.cloud/apigmao/{token}/projects
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of projects to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/projects' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "PROJ-001",
"title": "Mantenimiento Edificio A",
"project_code": "PRJ-2024-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/projects`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "PROJ-001",
"title": "Mantenimiento Edificio A",
"project_code": "PRJ-2024-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/projects"
r = requests.post(url, json={
'list': [
{
'erp_id': 'PROJ-001',
'title': 'Mantenimiento Edificio A',
'project_code': 'PRJ-2024-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/projects");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'PROJ-001',
'title': 'Mantenimiento Edificio A',
'project_code': 'PRJ-2024-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Proyectos actualizados correctamente"
}
deleteProjects
Elimina proyectos por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/projects
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/projects' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["PRY-001", "PRY-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/projects`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["PRY-001", "PRY-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/projects"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['PRY-001', 'PRY-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/projects");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['PRY-001', 'PRY-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Proyectos eliminados correctamente"
}
Stock
getStock
Obtiene una lista de stock por almacén/artículo. Requiere módulo de lotes activo.
GEThttps://{company}.gmao.cloud/apigmao/{token}/stock
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
item_id
Identifier del artículo
item_erp_id
Identificador ERP del artículo
wharehouse_id
Identifier del almacén
wharehouse_erp_id
Identificador ERP del almacén
lot
Código del lote
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/stock?page=0' \
-H "Content-Type: application/json" \
-d '{
"item_id": 1,
"item_erp_id": "ART-001",
"wharehouse_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/stock`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"item_id": 1,
"item_erp_id": "ART-001",
"wharehouse_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/stock"
r = requests.get(url, json={
'item_id': 1,
'item_erp_id': 'ART-001',
'wharehouse_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/stock");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'item_id': 1,
'item_erp_id': 'ART-001',
'wharehouse_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"stock": 50
}
],
"page": 0,
"total": 1
}
postStock
POSThttps://{company}.gmao.cloud/apigmao/{token}/stock
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of stock to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/stock' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"stock": 50,
"wharehouse_id": 1,
"wharehouse_erp_id": "ALM-001"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/stock`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"stock": 50,
"wharehouse_id": 1,
"wharehouse_erp_id": "ALM-001"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/stock"
r = requests.post(url, json={
'list': [
{
'stock': 50,
'wharehouse_id': 1,
'wharehouse_erp_id': 'ALM-001'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/stock");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'stock': 50,
'wharehouse_id': 1,
'wharehouse_erp_id': 'ALM-001'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Stock actualizado correctamente"
}
deleteStock
Elimina registros de stock por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/stock
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/stock' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["STK-001", "STK-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/stock`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["STK-001", "STK-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/stock"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['STK-001', 'STK-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/stock");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['STK-001', 'STK-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Stock eliminado correctamente"
}
Subcontracts
getSubcontracts
Obtiene una lista de subcontratas dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/subcontracts
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
service_provider
Filter by service providers
material_provider
Filter by material providers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/subcontracts?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"erp_ids": ["SUB-001", "SUB-002"],
"service_provider": true
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/subcontracts`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"erp_ids": ["SUB-001", "SUB-002"],
"service_provider": true
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/subcontracts"
r = requests.get(url, json={
'ids': [1, 2],
'erp_ids': ['SUB-001', 'SUB-002'],
'service_provider': true
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/subcontracts");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'erp_ids': ['SUB-001', 'SUB-002'],
'service_provider': true
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"erp_id": "SUB-001",
"name": "Servicios Técnicos S.L.",
"trade_name": "ServTec",
"email": "info@servtec.com",
"phone": "+34 93 123 4567"
}
],
"page": 0,
"total": 1
}
postSubcontracts
POSThttps://{company}.gmao.cloud/apigmao/{token}/subcontracts
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of subcontracts to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/subcontracts' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "SUB-001",
"name": "Servicios Técnicos S.L.",
"tax_id": "A87654321"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/subcontracts`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "SUB-001",
"name": "Servicios Técnicos S.L.",
"tax_id": "A87654321"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/subcontracts"
r = requests.post(url, json={
'list': [
{
'erp_id': 'SUB-001',
'name': 'Servicios Técnicos S.L.',
'tax_id': 'A87654321'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/subcontracts");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'SUB-001',
'name': 'Servicios Técnicos S.L.',
'tax_id': 'A87654321'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Subcontratas actualizadas correctamente"
}
deleteSubcontracts
Elimina subcontratas por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/subcontracts
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/subcontracts' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["PROV-001", "PROV-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/subcontracts`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["PROV-001", "PROV-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/subcontracts"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['PROV-001', 'PROV-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/subcontracts");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['PROV-001', 'PROV-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Subcontratas eliminadas correctamente"
}
Users
getUsers
Obtiene una lista de usuarios dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/users
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
role_id
Users role identifier
erp_id
Identificador ERP
subcontractor_ids
Subcontractors identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/users?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1],
"role_id": 1,
"erp_id": "erp_id"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/users`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1],
"role_id": 1,
"erp_id": "erp_id"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/users"
r = requests.get(url, json={
'ids': [1],
'role_id': 1,
'erp_id': 'erp_id'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/users");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1],
'role_id': 1,
'erp_id': 'erp_id'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"id": 1,
"role_id": 1,
"erp_id": "erp_id",
"name": "name",
"surname": "surname"
}
postUsers
Actualiza los usuarios en la base de datos. Si el usuario no existe, lo crea. Si existe, lo actualiza
POSThttps://{company}.gmao.cloud/apigmao/{token}/users
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of users to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/users' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "USR-001",
"password": "SecurePass123!",
"cost_value": 25
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/users`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "USR-001",
"password": "SecurePass123!",
"cost_value": 25
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/users"
r = requests.post(url, json={
'list': [
{
'erp_id': 'USR-001',
'password': 'SecurePass123!',
'cost_value': 25
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/users");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'USR-001',
'password': 'SecurePass123!',
'cost_value': 25
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Usuarios actualizados correctamente",
"tokens": [
{}
]
}
deleteUsers
Elimina usuarios por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/users
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/users' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["USR-001", "USR-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/users`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["USR-001", "USR-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/users"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['USR-001', 'USR-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/users");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['USR-001', 'USR-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Usuarios eliminados correctamente"
}
Whare houses
getWhareHouses
Obtiene una lista de almacenes dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/whareHouses
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
id
Identifier
erp_id
Identificador ERP
name
Nombre del almacén
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/whareHouses?page=0' \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"erp_id": "ALM-001",
"name": "Almacén Central"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/whareHouses`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1,
"erp_id": "ALM-001",
"name": "Almacén Central"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/whareHouses"
r = requests.get(url, json={
'id': 1,
'erp_id': 'ALM-001',
'name': 'Almacén Central'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/whareHouses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'id': 1,
'erp_id': 'ALM-001',
'name': 'Almacén Central'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"name": "Almacén Central",
"erp_id": "ALM-001"
}
],
"page": 0,
"total": 1
}
postWhareHouses
POSThttps://{company}.gmao.cloud/apigmao/{token}/whareHouses
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of whare-houses to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/whareHouses' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "ALM-001",
"name": "Almacén Central",
"client_id": 1
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/whareHouses`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "ALM-001",
"name": "Almacén Central",
"client_id": 1
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/whareHouses"
r = requests.post(url, json={
'list': [
{
'erp_id': 'ALM-001',
'name': 'Almacén Central',
'client_id': 1
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/whareHouses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'ALM-001',
'name': 'Almacén Central',
'client_id': 1
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Almacenes actualizados correctamente"
}
deleteWhareHouses
Elimina almacenes por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/whareHouses
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/whareHouses' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["ALM-001", "ALM-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/whareHouses`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["ALM-001", "ALM-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/whareHouses"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['ALM-001', 'ALM-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/whareHouses");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['ALM-001', 'ALM-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Almacenes eliminados correctamente"
}
Work order state
deleteWorkOrderState
Elimina estados de orden de trabajo por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/workOrderState
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/workOrderState' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["EST-001", "EST-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/workOrderState`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["EST-001", "EST-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/workOrderState"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['EST-001', 'EST-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/workOrderState");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['EST-001', 'EST-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Estados de orden de trabajo eliminados correctamente"
}
Work orders
getWorkOrders
Obtiene una lista de OT's dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/workOrders
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP identifiers
project_id
Project identifier
project_code
Project code
project_erp_id
Project ERP identifier
subcontractor_ids
Subcontractors identifiers
customer_id
Customer identifier
customer_ids
Customers identifier
customer_erp_id
Customer ERP identifier
address_id
Address identifier
address_ids
Addresses identifier
address_erp_id
Address ERP identifier
model_id
model identifier
model_erp_id
Model ERP identifier
specialty_id
Specialty identifier
specialty_erp_id
Specialty ERP identifier
external_reference
External reference
date
Date
date_from
Date from. Must use date_to twice
date_to
Date to. Must use date_from twice
remote_id
Remote identifier
workorder_type_id
Work order type identifier (partes.id_tipo)
type
Filtra por tipo de OT. Acepta un string o array de strings.
status_flag
Status flags
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/workOrders?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1001, 1002],
"erp_ids": ["OT-001", "OT-002"],
"project_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/workOrders`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1001, 1002],
"erp_ids": ["OT-001", "OT-002"],
"project_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/workOrders"
r = requests.get(url, json={
'ids': [1001, 1002],
'erp_ids': ['OT-001', 'OT-002'],
'project_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/workOrders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1001, 1002],
'erp_ids': ['OT-001', 'OT-002'],
'project_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1001,
"erp_id": "BC-43",
"duration": 120,
"date": "2024-01-15",
"observations": "Revisión anual programada",
"required": false
}
],
"page": 0,
"total": 1
}
postWorkOrders
Crea o actualiza OTs en la base de datos. <br><br><b>Hay 3 operaciones especiales</b> que, si se informan, deben venir acompañadas de un identificador de OT y <b>no pueden combinarse con otros campos</b>: <br>· <b>status_flag</b>: cambia el estado de la OT al indicado. Identificador: id, erp_id o remote_id. <br>· <b>assets</b>: reemplaza los activos asociados a la OT. Array de id_remoto de activo. Identificador: remote_id (= id interno de la OT). <br>· <b>materials</b>: reemplaza las líneas de material de la OT. Array de objetos con remote_id, quantity, planned_units (solo si la OT es de tipo suministro), observations, unit_price. Identificador: remote_id (= id interno de la OT).
POSThttps://{company}.gmao.cloud/apigmao/{token}/workOrders
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of work-orders to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/workOrders' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "OT-001",
"id": 1001,
"status_flag": "SEND_TO_ERP"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/workOrders`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "OT-001",
"id": 1001,
"status_flag": "SEND_TO_ERP"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/workOrders"
r = requests.post(url, json={
'list': [
{
'erp_id': 'OT-001',
'id': 1001,
'status_flag': 'SEND_TO_ERP'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/workOrders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'OT-001',
'id': 1001,
'status_flag': 'SEND_TO_ERP'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "OT's actualizadas correctamente"
}
deleteWorkOrders
Elimina órdenes de trabajo por ID o identificador ERP
DELETEhttps://{company}.gmao.cloud/apigmao/{token}/workOrders
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
ids
Identifiers
erp_ids
ERP Identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X DELETE 'https://{company}.gmao.cloud/apigmao/<TOKEN>/workOrders' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2, 3],
"erp_ids": ["OT-001", "OT-002"]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/workOrders`, {
method: "DELETE",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2, 3],
"erp_ids": ["OT-001", "OT-002"]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/workOrders"
r = requests.delete(url, json={
'ids': [1, 2, 3],
'erp_ids': ['OT-001', 'OT-002']
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/workOrders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2, 3],
'erp_ids': ['OT-001', 'OT-002']
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Órdenes de trabajo eliminadas correctamente"
}
Validation billable
getValidationBillable
Returns the list of billable work order lines for the given filter. Returns the same columns as the Validations > Exports Excel. The response (data) is a list of rows: work orders not yet valued produce one main row (main = true), and valued ones produce one summary row (first = true) plus one row per line. Fields of each row: date, reference, project, task, client_name, task_type, qty, unit_price, travel, kms, materials, description (invoice text, prefixed with "NUM OT {wo_id}."), total_amount and wo_id. The travel, kms and materials fields exist in the Excel and are always null; qty, unit_price and total_amount are null in the main row and in the summary row. The query does not mark work orders as exported: after importing them, the consumer marks them with POST validationBillable (mark: true, same as the Exports Excel) and then filters with exported: false to avoid receiving them again. The response is paginated by row, 50 per page: use the page query parameter (starts at 0) and keep requesting pages until data comes back empty. The response also carries page (the requested page), page_size (50) and total (number of rows that match the filter): the number of pages is ceil(total / page_size). Empty values are null, never an empty string.
GEThttps://{company}.gmao.cloud/apigmao/{token}/validationBillable
Authorizations
token
Tenant API token passed in the URL path.
Body filters
Content-Type: application/json
project_code
Project code
project_erp_id
Project ERP identifier
project_id
Project identifier
client_erp_id
Client ERP identifier
client_id
Client identifier
date_from
Date from (yyyy-mm-dd)
date_to
Date to (yyyy-mm-dd)
status_flags
status_flags
exported
false: only work orders without the exported mark; true: only the already marked ones (a 14-digit timestamp in id_erp; an external id_erp does not count as exported). If omitted, all. They are marked with POST validationBillable
wo_ids
Work orders identifiers
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/validationBillable?page=0' \
-H "Content-Type: application/json" \
-d '{
"project_code": "PRJ-2024",
"project_erp_id": "PROJ-001",
"project_id": 1
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/validationBillable`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"project_code": "PRJ-2024",
"project_erp_id": "PROJ-001",
"project_id": 1
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/validationBillable"
r = requests.get(url, json={
'project_code': 'PRJ-2024',
'project_erp_id': 'PROJ-001',
'project_id': 1
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/validationBillable");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'project_code': 'PRJ-2024',
'project_erp_id': 'PROJ-001',
'project_id': 1
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"date": "2026-05-10",
"reference": "4900139077",
"project": "M0654GRI",
"task": "32000",
"client_name": "GRIFOLS ENGINEERING, S.A",
"task_type": "C"
}
],
"page": 0,
"total": 1
}
postValidationBillable
Marks (mark: true) or unmarks (mark: false) the given billable work orders as exported, same as the Validations > Exports Excel. Use it after importing the rows from GET validationBillable; afterwards, GET with exported: false returns only the pending ones.
POSThttps://{company}.gmao.cloud/apigmao/{token}/validationBillable
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
wo_ids
Identifiers of the billable work orders to mark or unmark
mark
Required, no default value. true: marks the work orders as exported (partes.id_erp = timestamp, same as the Exports Excel). false: unmarks them. In both cases a work order whose id_erp is an external identifier (not a 14-digit timestamp) is left untouched and returned in ignored. Maximum 500 identifiers per call; the operation is all-or-nothing
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/validationBillable' \
-H "Content-Type: application/json" \
-d '{
"wo_ids": [70711, 70712],
"mark": true
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/validationBillable`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"wo_ids": [70711, 70712],
"mark": true
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/validationBillable"
r = requests.post(url, json={
'wo_ids': [70711, 70712],
'mark': true
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/validationBillable");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'wo_ids': [70711, 70712],
'mark': true
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": {}
}
Work order states
getWorkOrderStates
Obtiene una lista de estados de OT dependiendo del filtro aplicado
GEThttps://{company}.gmao.cloud/apigmao/{token}/workOrderStates
Authorizations
token
Tenant API token passed in the URL path.
Query parameters
page
50 record page number required
Body filters
Content-Type: application/json
ids
Identifiers
status_flag
Status flags
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 501 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X GET 'https://{company}.gmao.cloud/apigmao/<TOKEN>/workOrderStates?page=0' \
-H "Content-Type: application/json" \
-d '{
"ids": [1, 2],
"status_flag": "SEND_TO_ERP"
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/workOrderStates`, {
method: "GET",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ids": [1, 2],
"status_flag": "SEND_TO_ERP"
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/workOrderStates"
r = requests.get(url, json={
'ids': [1, 2],
'status_flag': 'SEND_TO_ERP'
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/workOrderStates");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'ids': [1, 2],
'status_flag': 'SEND_TO_ERP'
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": [
{
"id": 1,
"name": "Enviado a ERP"
}
],
"page": 0,
"total": 1
}
postWorkOrderStates
Actualiza los estados de OT de la base de datos. También asignar un estado predetermiando a un estado de OT.
POSThttps://{company}.gmao.cloud/apigmao/{token}/workOrderStates
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
list
Array of work-order-states to create or update. See full schema in the OpenAPI spec.
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/workOrderStates' \
-H "Content-Type: application/json" \
-d '{
"list": [
{
"erp_id": "EST-001",
"name": "Enviado a ERP",
"status_flag": "SEND_TO_ERP"
}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/workOrderStates`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"list": [
{
"erp_id": "EST-001",
"name": "Enviado a ERP",
"status_flag": "SEND_TO_ERP"
}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/workOrderStates"
r = requests.post(url, json={
'list': [
{
'erp_id': 'EST-001',
'name': 'Enviado a ERP',
'status_flag': 'SEND_TO_ERP'
}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/workOrderStates");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'list': [
{
'erp_id': 'EST-001',
'name': 'Enviado a ERP',
'status_flag': 'SEND_TO_ERP'
}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "Estados de OT's creados correctamente"
}
Internal stack
postInternalStack
POSThttps://{company}.gmao.cloud/apigmao/{token}/internalStack
Authorizations
token
Tenant API token passed in the URL path.
Body payload
Content-Type: application/json
actions
Errors
| Status | Meaning |
|---|---|
| 200 | Successful operation. |
| 303 | Forbidden |
| 404 | No records found. |
| 503 | Service unavailable. |
Request
cURLNodePythonPHP
curl -X POST 'https://{company}.gmao.cloud/apigmao/<TOKEN>/internalStack' \
-H "Content-Type: application/json" \
-d '{
"actions": [
{}
]
}'
const res = await fetch(`https://{company}.gmao.cloud/apigmao/${token}/internalStack`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"actions": [
{}
]
})
});
const data = await res.json();
import requests
url = f"https://{company}.gmao.cloud/apigmao/{token}/internalStack"
r = requests.post(url, json={
'actions': [
{}
]
})
data = r.json()
<?php
$ch = curl_init("https://{company}.gmao.cloud/apigmao/$token/internalStack");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode({
'actions': [
{}
]
}));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$res = curl_exec($ch);
Response
200 OKapplication/json
{
"data": "value"
}