Forum
See question

Ajuda com integração via API – Problema ao comunicar a série de faturação   

27 views
« Back to Previous Page
0
♥ 0

Olá a todos,

Estou a tentar comunicar a série de faturação através da API do Jasmin, mas infelizmente continuo a receber uma resposta de erro e não consigo entender o que está a falhar.

Já li toda a documentação disponível e testei várias abordagens:

  • Enviar todos os parâmetros obrigatórios e também os opcionais;

  • Utilizar os nomes dos campos conforme aparecem na documentação e também em camelCase, conforme são retornados na resposta da chamada GET da série;

  • Modificar valores e estruturar o payload de diferentes formas, com base nos exemplos.

Mesmo assim, continuo a receber a seguinte resposta:

{
"message": "This method should be overridden",
"%CORRELATIONID%": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"%SOURCE%": "UnhandledExceptionMiddleware"
}

Este é o conteúdo da request que estou a enviar:

[
  {
    “company”:”XXXXX”,
    “selected”: false,
    “serie”: “XXXXX”,
    “documentType”: “FA”,
    “documentTypeId”: “2xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx“,
    “fiscalDocumentType”: “FT”,
    “lastUsedNumber”: 1,
    “lastDate”: “2025-06-19T13:43:35.5518783+00:00”,
    “schemaEntityId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx“,
    “schemaEntityNaturalKey”: “INVOICETYPES.SALESCORE”
  }
]

Obs: os valores e nomes foram anonimizados.

Alguém já passou por este problema ou tem alguma ideia do que pode estar a causar este comportamento?
Agradeço muito qualquer orientação ou sugestão!

Obrigado desde já,
Claudia

Faça login para poder traduzir
API Endpoints
Integration
Jasmin
Marked as spam
Created 1 year and 3 months ago inposia
i
inposia INPOSIA Iniciante
2 answers
0
Private answer

obrigado por o ajudar, apenas uma necessidade da sua documentação não está completa, clique neste link para não receber qualquer resposta https://jasminsoftware.github.io/taxescore.seriescommunications.html#ATCommunicateSeriesAction
pode verificar?

Faça login para poder traduzir
Marked as spam
Created 1 year and 3 months ago inposia
i
inposia INPOSIA Iniciante
    Comments
    De facto há uma falha na documentação que não apresenta o enumerado em causa. Os valores possíveis são os mesmos que são apresentados na aplicação na opção Impostos -> Comunicar Séries. Os valores são os seguinte: Register, Finish e Annul
    1 year and 1 month ago
    eduardosilva
      0
      Private answer

      Bom dia.
      Infelizmente não nos indica aqui qual o endpoint que está a utilizar, por isso não podemos fazer nenhum comentário quanto ao body que está a enviar ou o erro que está a obter.
      De qualquer forma, pesquisando a opção "CommunicateSeries" é fácil encontrar qual o endpoint a utilizar.

      https://jasminsoftware.github.io/taxescore.seriescommunications.html#f9896546-2d3d-4d01-adec-b55470b9ff71
      POST /taxesCore/seriesCommunications/communicateSeries

      Conforme a documentação, basta no body do pedido indicar qual a empresa e tipode ação que pretende, seguida da lista de series a
      comunicar:
      A título de exemplo aqui fica um pedido de comunicação para registo da série "2025" no tipo de documento ORC para a empresa "DEMO" (podem naturalmente indicar uma lista com várias séries a comunicar)

      {
    "company" : "DEMO",
    "action" : "Register",
    "communicateSeriesLines" : 
    [
        {
            "series" : "2025",
            "documentType": "ORC",
            "fiscalDocumentType" : "OR"
        }
    ]
}

      Notem que:

      • na informação das linhas das séries a comunicar, para além da série, será sempre necessário indicar quer o tipo de documento quer o tipo fiscal do respetivo documento
      • na execução deste comando,  a aplicação irá criar automaticamente a série tipo de documento + série (neste exemplo "ORC2025") e será essa a série comunicada à AT, à semelhança do que acontece se utilizarem o interface do Jasmin.

       

      Faça login para poder traduzir
      Marked as spam
      Created 1 year and 3 months ago eduardosilva
      e
      eduardosilva Eduardo SILVA Responsiveness Member
        « Back to Previous Page