Documentação da API — ActHub v1

Autentica o usuário e retorna um token JWT.

{
  "userName": "string",   // obrigatório
  "password": "string"    // obrigatório
}

POST /Admin/auth
Content-Type: application/json

{
  "userName": "seu_usuario",
  "password": "sua_senha"
}

// Response 200 — Token JWT
// Use no header: Authorization: Bearer {token}

Faz download dos logs de erros do sistema.

200 — OK

Executa limpeza de dados temporários e cache interno.

200 — OK

Recicla (tenta processar novamente) os itens da fila de processamento.

200 — OK

Executa o setup inicial para o target especificado.

200 — OK

Retorna o status atual da fila de processamento.

200 — OK

Retorna a lista de novos clientes registrados.

200 — Array de Client

500 — Internal Server Error

Registra o log de um novo pedido recebido.

{
  "order": { /* Order object */ },
  "request": "string",
  "response": "string"
}

200 — OK

400 — Bad Request (ProblemDetails)

Consulta logs de sincronização por tipo de entidade e ID de origem.

200 — Array de LogEntry

Busca o mapeamento de uma entidade específica pelo tipo e ID de origem.

200 — Array de MapItem

404 — Not Found

Remove o mapeamento de uma entidade específica.

200 — OK

404 — Not Found

Lista todos os mapeamentos de um tipo de entidade.

200 — Array de MapItem

Cria um novo registro de mapeamento entre source e target.

{
  "sourceID": "string",
  "targetID": "string",
  "entity": 0           // EntityType enum
}

200 — OK

400 — Bad Request

Consulta um pedido pelo ID do target (e-commerce).

200 — Order

Retorna a lista de pedidos novos (ainda não processados pelo ERP).

200 — Array de Order

Retorna pedidos pendentes de processamento.

200 — Array de Order

Envia notas fiscais vinculadas a pedidos.

[
  {
    "targetID": "string",
    "companyCode": "string",
    "orderTargetID": "string",
    "orderSourceID": "string",
    "number": "string",
    "serie": "string",
    "value": 0.0,
    "date": "2026-01-01T00:00:00Z",
    "url": "string",
    "key": "string",
    "items": [
      {
        "targetID": "string",
        "sourceID": "string",
        "price": 0.0,
        "cfop": "string",
        "quantity": 0.0,
        "companyCode": "string"
      }
    ]
  }
]

200 — OK (string)

400 — Bad Request

Registra informações de expedição/rastreio de um pedido.

{
  "targetID": "string",
  "companyCode": "string",
  "orderTargetID": "string",
  "orderSourceID": "string",
  "trackingNumber": "string",
  "trackingUrl": "string",
  "courier": "string",
  "date": "2026-01-01T00:00:00Z"
}

200 — OK (string)

400 — Bad Request

Sinaliza que o ERP iniciou o tratamento do pedido.

{
  "sourceId": "string",
  "targetId": "string",
  "message": "string"
}

200 — OK (string)

400 — Bad Request

Cancela um pedido na plataforma de e-commerce.

{
  "sourceId": "string",
  "targetId": "string"
}

200 — OK (string)

400 — Bad Request

Envia uma mensagem/observação para o pedido no e-commerce.

{
  "sourceId": "string",
  "targetId": "string",
  "message": "string"
}

200 — OK (string)

400 — Bad Request

Enfileira um pedido para reprocessamento.

{
  "sourceID": "string",
  "message": "string"
}

200 — OK (string)

400 — Bad Request

Lista todos os parâmetros de configuração.

200 — Array de Param

Cria um novo parâmetro de configuração.

{
  "id": "string",
  "value": "string",
  "description": "string",
  "type": 1              // ParamType enum
}

200 — OK

Atualiza um parâmetro de configuração existente.

{
  "id": "string",
  "value": "string",
  "description": "string",
  "type": 1
}

Busca um parâmetro pelo ID.

200 — Param

404 — Not Found

Remove um parâmetro pelo ID.

404 — Not Found

Consulta o status de um item da fila.

200 — SchedulerItem

404 — Not Found

Reprocessa um item da fila.

200 — boolean

Remove um item da fila de sincronização.

200 — OK

404 — Not Found

Retorna o último item executado na fila.

200 — SchedulerItem

404 — Not Found