automcp

API do Sage

Mostre ao cliente se há stock para a quantidade que quer comprar. A sua loja consulta o Sage 50c por HTTPS e recebe a disponibilidade de cada armazém em JSON.

Candeeiro de mesa Lume em verde-floresta, aceso sobre um fundo terracota.
Candeeiro LumeArtigo da loja de exemplo 15 un.em Lisboa

Há três candeeiros para levantar no Porto?

A loja consulta o Sage antes de aceitar a encomenda. Experimente a decisão do comprador com os dados fictícios abaixo.

O que o Sage devolve

GET /api/v1/stocks?artigo=LUME-01
Stock do candeeiro Lume por armazém, em unidades
ArmazémFísicoDisponível
Lisboa 1815
Porto 62
Braga 30

O PhysicalQty indica quantas unidades estão no armazém. A loja usa o AvailableQty para decidir quantas pode oferecer ao cliente.

Ver excerto em JSON
{
    "dados": [
        {
            "ItemID": "LUME-01",
            "WarehouseID": 1,
            "WarehouseDescription": "Lisboa",
            "PhysicalQty": 18,
            "AvailableQty": 15
        },
        {
            "ItemID": "LUME-01",
            "WarehouseID": 2,
            "WarehouseDescription": "Porto",
            "PhysicalQty": 6,
            "AvailableQty": 2
        },
        {
            "ItemID": "LUME-01",
            "WarehouseID": 3,
            "WarehouseDescription": "Braga",
            "PhysicalQty": 3,
            "AvailableQty": 0
        }
    ]
}

O que o cliente vê

Candeeiro Lume

Verde-floresta · Ref. LUME-01

Só há 2 unidades disponíveis

Pediu 3 unidades. Pode levar duas no Porto ou recolher as três em Lisboa.

Ver o mesmo stock numa conversa de exemplo

Exemplos de consultas

Escolha uma área para explorar os dados que pode levar do Sage 50c para a sua aplicação.

Ver todas as consultas
Escolha a área da consulta

Quanto custa, em média, uma unidade?

Leve a referência, a descrição e a unidade de venda do Sage para o seu catálogo interno. O custo médio ajuda a equipa a preparar orçamentos.

Custo médio de uma resma de papel A4
3,42 €
GET/api/v1/artigos?artigo=PAPEL-A4

Excerto de uma resposta de exemplo

{
  "dados": [{
    "ItemID": "PAPEL-A4",
    "Description": "Resma de papel A4",
    "UnitOfSaleID": "UN",
    "CurrencyID": "EUR",
    "AverageCostPrice": 3.42
  }]
}

Qual foi a rotação deste artigo?

Compare as unidades vendidas com o stock médio do período para decidir que artigos vale a pena repor.

Rotação em setembro, com 12 unidades vendidas e 24 em stock médio
0,5 vezes
GET/api/v1/rotacao?inicio=2026-09-01&fimExclusivo=2026-10-01&artigo=PAPEL-A4

Excerto de uma resposta de exemplo

{
  "dados": [{
    "ItemID": "PAPEL-A4",
    "UnidadesSaidasVenda": 12,
    "StockMedioUnidades": 24,
    "RotacaoPeriodo": 0.5
  }]
}

Quanto faturámos em setembro?

Leve a faturação mensal para o seu painel de vendas. A consulta separa os totais por tipo de documento e moeda.

Faturação sem imposto em 32 faturas
12 480 €
GET/api/v1/vendas?inicio=2026-09-01&fimExclusivo=2026-10-01

Excerto de uma resposta de exemplo

{
  "dados": [{
    "mes": "2026-09-01T00:00:00",
    "tipo_documento": "FAC",
    "moeda": "EUR",
    "documentos": 32,
    "faturacao_sem_imposto": 12480
  }]
}

Quanto comprámos a cada fornecedor?

Compare os valores mensais por fornecedor e tipo de documento para perceber onde se concentram as compras.

Compras sem imposto em 8 faturas do fornecedor 42
2 360 €
GET/api/v1/compras?inicio=2026-09-01&fimExclusivo=2026-10-01

Excerto de uma resposta de exemplo

{
  "dados": [{
    "fornecedor_documento_id": 42,
    "tipo_documento": "FAC",
    "moeda": "EUR",
    "documentos": 8,
    "compras_sem_imposto": 2360
  }]
}

Este cliente tem a ficha ativa?

Apresente no CRM o estado da ficha comercial e a tabela de preços associada ao cliente no Sage.

Oficina do Papel, cliente 120
Ficha ativa
GET/api/v1/clientes

Excerto de uma resposta de exemplo

{
  "dados": [{
    "CustomerID": 120,
    "OrganizationName": "Oficina do Papel",
    "ActiveParty": true,
    "PriceLineID": 1
  }]
}

Que valor falta receber?

Consulte as prestações emitidas no período e organize as cobranças por cliente, data de vencimento e montante ainda em aberto.

Por receber do cliente 120, com vencimento a 15 de outubro
480 €
GET/api/v1/financeiro-clientes?inicio=2026-09-01&fimExclusivo=2026-10-01

Excerto de uma resposta de exemplo

{
  "dados": [{
    "CustomerID": 120,
    "DeferredPaymentDate": "2026-10-15T00:00:00",
    "CurrencyID": "EUR",
    "TotalPendingAmount": 480
  }]
}

O que a sua aplicação pode mostrar

  • No ponto de recolha

    Uma encomenda de três candeeiros excede o stock do Porto. A loja oferece as duas unidades disponíveis ou a recolha das três em Lisboa.

    Experimentar o pedido
  • Na reunião de vendas

    Para fechar setembro, o painel mostra 32 faturas em euros e 12 480 € de faturação sem imposto. A equipa vê o que entra no total.

    Ver os dados de vendas
  • No portal do cliente

    Ao abrir a conta, o cliente encontra a prestação de 480 € que continua por pagar e o vencimento de 15 de outubro.

    Ver os dados da prestação
Testar a API no Postman

Como funciona a integração

  1. Configure o acesso

    Na sua aplicação, configure o endereço HTTPS e a chave de leitura da empresa. As permissões da chave determinam as áreas disponíveis.

  2. Escolha os dados

    Faça um pedido GET com a chave Bearer no cabeçalho de autorização. Para consultar vendas, por exemplo, indique a data inicial e o primeiro dia fora do período.

  3. Use a resposta em JSON

    Leia os campos de que a sua aplicação precisa. Nas consultas paginadas, peça a página seguinte para continuar a percorrer os registos.

Fazer a primeira consulta

Quer ligar a sua loja ao Sage?

Peça a adesão à API do Sage. Diga-nos que aplicação pretende ligar e que dados precisa de consultar para conversarmos sobre o acesso da sua empresa.

Pedir adesão por e-mail
E-mail comercial
contato@automcp.pt
Telefone fictício
+351 000 000 000