Documentação da API

O AGT Gateway é uma API intermediária responsável por transformar e enviar dados provenientes dos sistemas Sílica para o padrão exigido pela AGT.

Ela valida os dados recebidos, converte para o formato oficial da AGT e envia as requisições para processamento fiscal.

Base URL padrão:
https://fe.silicaerp.com/api

Arquitetura

A API é composta por dois principais serviços:

Todas as requisições devem conter o objeto obrigatório companydependency, que identifica a empresa emissora.

CampoTipoDescrição
establishmentNumberstringNúmero do estabelecimento fiscal
companytaxidstringNIF da empresa
privatekeyclientstringChave privada do cliente

Series API

Responsável pela criação e listagem de séries fiscais na AGT.

Criar Série

POST /api/series/create

Cria uma nova série fiscal para um determinado tipo de documento.

{
  "companydependency": {
    "establishmentNumber": "001",
    "companytaxid": "1234567890",
    "privatekeyclient": "abc123"
  },
  "seriesYear": 2025,
  "documentType": "FT"
}

Parâmetros:

CampoObrigatórioDescrição
seriesYearNãoAno da série
documentTypeSimTipo do documento (FT, FR, NC, RC)

Invoices API

Responsável pela criação e consulta de documentos fiscais.

Fatura (FT)

POST /api/invoices/createFT

Cria uma fatura normal.

{
  "companydependency": {...},
  "invoice": {
    "invoicenumber": "FT202500001"
  },
  "invoiceline": [
    {
      "invoiceNumber": "FT202500001"
    }
  ]
}

Fatura Recibo (FR)

POST /api/invoices/createFR

Emite uma fatura recibo integrada.

Nota de Crédito (NC)

POST /api/invoices/createNC

Emite uma nota de crédito associada a uma fatura anterior.

Status do Documento

POST /api/invoices/documentStatus
{
  "companydependency": {...},
  "requestID": "123456789012"
}

Consulta o estado atual do processamento do documento na AGT.

Tratamento de Erros

A API retorna sempre um objeto padrão:

{
  "success": false,
  "message": "Descrição do erro"
}

Erros possíveis: