Bug Report: Erro 500 ao consultar fatura via Webservice AGT

[cacimboangola]

Bug Report: Erro 500 ao consultar fatura via Webservice AGT

Resumo

Ao efetuar requisição POST para o endpoint oficial de consulta de faturas da AGT, o servidor retorna HTTP 500 - Internal Server Error com mensagem genérica, impedindo a consulta de faturas mesmo com payload válido e assinado.

---

Comportamento Atual (Incorreto)

Resposta do Servidor

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
  "errorMessage": "REST Business Service returned HTTP response with status 400"
}

Problema: O servidor retorna erro interno (500) quando deveria retornar um erro específico do cliente (400) com detalhes da validação que falhou.

---

Comportamento Esperado

O Webservice deveria:

1. Retornar HTTP 200 OK com os dados da fatura caso a consulta seja bem-sucedida
2. Retornar HTTP 400 Bad Request com código de erro específico (E04, E07, etc.) em caso de validação inválida
3. Fornecer mensagem descritiva sobre o problema (JSON inválido, assinatura incorreta, fatura inexistente, etc.)
4. Nunca retornar erro 500 para problemas de validação de entrada

---

Detalhes Técnicos

Endpoint

POST https://sifphml.minfin.gov.ao/sigt/fe/v1/consultarFactura

Ambiente

Campo	Valor
Sistema	Cacimbo ERP
Versão	8
Ambiente	Homologação
Validation Number	61/AGT/2019
NIF	5417167444
Data/Hora	2025-10-15T23:09:10Z
Método HTTP	POST

---

Payload Enviado

Request Headers

POST /sigt/fe/v1/consultarFactura HTTP/1.1
Host: sifphml.minfin.gov.ao
Content-Type: application/json
Accept: application/json

Request Body

{
  "schemaVersion": "1.01",
  "submissionGUID": "1a60b8d8-6328-4b5c-8913-abbc87ca145c",
  "taxRegistrationNumber": "5417167444",
  "submissionTimeStamp": "2025-10-15T23:09:10.893261Z",
  "invoiceNo": "FT PS142025/V757",
  "softwareInfo": {
    "softwareInfoDetail": {
      "productId": "Cacimbo ERP/CACIMBO - ANGOLAN SOFTWARE FACTORY, LDA",
      "productVersion": "8",
      "softwareValidationNumber": "61/AGT/2019"
    },
    "jwsSoftwareSignature": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    }
    "jwsSignature": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."  
}

Validação do Payload

• ✅ JSON válido (testado com JSON Linter)
• ✅ Schema version correto: 1.01
• ✅ GUID no formato UUID válido
• ✅ NIF correto e validado
• ✅ Timestamp no formato ISO 8601
• ✅ Assinaturas JWS presentes

---

Análise do Problema

Mensagem de Erro Recebida

{
  "errorMessage": "REST Business Service returned HTTP response with status 400"
}

Interpretação

A mensagem indica que:

1. O serviço REST interno da AGT está retornando status 400
2. O gateway/proxy não está tratando corretamente este erro
3. Em vez de repassar o 400 ao cliente, retorna 500 (erro do servidor)
4. A mensagem de erro original (que deveria explicar o problema) está sendo perdida

Possíveis Causas

1. Bug no gateway/API Gateway: Não está repassando corretamente os erros 400 do serviço interno
2. Tratamento de exceção inadequado: Catch genérico que transforma todos os erros em 500
3. Validação assíncrona: Erro ocorre após validação inicial, mas antes do processamento
4. Problema com assinatura JWS: Validação falha mas não retorna erro específico
5. Fatura inexistente: Sistema não trata corretamente quando invoiceNo não existe

---

Impacto

• Severidade: CRÍTICA
• Frequência: Ocorre em 100% das tentativas de consulta
• Impacto: Impossibilita completamente a consulta de faturas via API
• Workaround: ❌ Nenhum disponível (consulta manual não é solução viável)

Consequências

• ✗ Impossibilidade de integração automatizada
• ✗ Falta de rastreabilidade de faturas
• ✗ Debugging impossível (sem detalhes do erro real)
• ✗ Experiência negativa para desenvolvedores

---

Passos para Reproduzir

Via cURL

curl -X POST https://sifphml.minfin.gov.ao/sigt/fe/v1/consultarFactura \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "schemaVersion": "1.01",
    "submissionGUID": "1a60b8d8-6328-4b5c-8913-abbc87ca145c",
    "taxRegistrationNumber": "5417167444",
    "submissionTimeStamp": "2025-10-15T23:09:10.893261Z",
    "invoiceNo": "FT PS142025/V757",
    "softwareInfo": {
      "softwareInfoDetail": {
        "productId": "Cacimbo ERP/CACIMBO - ANGOLAN SOFTWARE FACTORY, LDA",
        "productVersion": "8",
        "softwareValidationNumber": "61/AGT/2019"
      },
      "jwsSoftwareSignature": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
      }
      "jwsSignature": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."    
  }'

Resultado Esperado

{
  "invoiceNo": "FT PS142025/V757",
  "invoiceDate": "2025-10-15",
  "customerTaxID": "...",
  ...
}

Resultado Obtido

HTTP/1.1 500 Internal Server Error

{
  "errorMessage": "REST Business Service returned HTTP response with status 400"
}

Informações Adicionais

Testes Realizados

• ✅ Validação do JSON (válido)
• ✅ Teste com diferentes invoiceNo (mesmo erro)
• ✅ Verificação de assinaturas JWS (presentes)
• ✅ Teste em diferentes horários (mesmo erro)
• ✅ Teste com diferentes GUIDs (mesmo erro)
• ✅ Teste com diferentes formatos de invoiceNo:
  • "FT PS142025/V757" → Erro 500
  • "FT2025/0001" → Erro 500
  • "FT FT2025/0001" → Erro 500

Variações Testadas de invoiceNo

Formato	Resultado
FT PS142025/V757	Erro 500 ❌
FT2025/0001	Erro 500 ❌
FT FT2025/0001	Erro 500 ❌
PS142025/V757	Erro 500 ❌

Logs de Requisição (Timestamp)

2025-10-15T23:09:10.893261Z - Request enviado
2025-10-15T23:09:11.234567Z - Response 500 recebido (tempo: ~341ms)

Comparação com Outros Endpoints

Endpoint	Status
enviarFactura	✅ Funciona corretamente
consultarFactura	❌ Erro 500 (este bug)
listarFacturas	❌ Retorna 0 documentos

---

Contacto

Empresa: Cacimbo - Angolan Software Factory, LDA
Software: Cacimbo ERP v8
Validation Number: 61/AGT/2019
Endpoint Afetado: consultarFactura
NIF de Teste: 5417167444

---

[aramalhosa]

Bom dia,

Só para complementar que estamos a ter a mesma situação ao invocar o serviço para obter o estado de uma fatura submetida.

[cacimboangola]

Quase Todos endpoints estão dando erro 500

[cryptolopes]

Alguma evolução em relação a este assunto?