Forum
See question

Criar Guia de Transporte via WebAPI   

98 views
1
0

Boa tarde,

Estou a tentar encontrar documentação (e idealmente exemplos) de como criar uma guia de transporte via WebApi.

Tanto quanto consegui perceber até ao momento, deve ser criado um documento utilizando a API:

{{apiUrl}}Vendas/Docs/CreateDocument/

Passando a informação no tipo de documento a indicar que é uma guia de transporte:

“Tipodoc”: “GT”,
Na documentação deste método no postman, apenas estão identificados alguns campos base (que servem bem para criar facturas):
{
  “Linhas”: [
    {
      “Artigo”: “A0001”,
      “Quantidade”: “1”
    },
    {
      “Artigo”: “A0002”,
      “Quantidade”: “1”
    }
  ],
  “Tipodoc”: “FA”,
  “Serie”: “C”,
  “Entidade”: “Sofrio”,
  “TipoEntidade”: “C”,
  “DataDoc”:”12/11/2018″,
  “DataVenc”:”12/12/2018″
}
Será que alguém tem experiência e / ou exemplos de como criar uma guia de transporte?
Diria que para criar uma guia de transporte tenho que fornecer, além da lista de artigos a transportar (Linhas) a informação da viatura, locais e datas de carga e descarga. Qual a estrutura na qual devo enviar esta informação?
Não encontro referências ou exemplos com este tipo de documento.
Além disso, pretendo que estas guias de transporte sejam comunicadas a AT. Tenho que ter em conta mais algum campo / informação?
Muito obrigado pela ajuda,
Miguel Vaz
Faça login para poder traduzir
API Endpoints
V10
Marked as spam
Created 1 year and 3 months ago miguelvaz-2
miguelvaz-2 Iniciante
3 answers
0
Private answer

Olá @miguelvaz-2

Vê a minha resposta a uma questão deste fórum no seguinte link

Os passos são os mesmos para criar a GT, e conforme referiste o "PreencheDadosRelacionados" ajuda a determinar quais os campos adicionais a preencher (matricula, carga, descarga, etc.).

Deves conseguir gravar a GT, no entanto, isso não inclui a comunicação à AT.
Para esse efeito, como referiu o @sergiosereno, será necessário recorrer à extensibilidade, porque não encontrei referencia ao modulo de Transações eletrônicas na WebAPI.

Faça login para poder traduzir
Marked as spam
Created 1 year and 3 months ago emiliosusavila
emiliosusavila Responsiveness Member
    Comments
    Muito obrigado @emiliosusavila pela resposta. Vou tentar seguir o processo enviado no link para o forum. Vou também analisar a possibilidade de usar extensibilidade muito embora, como integrador, prefira sempre estar apenas do lado de cliente das APIs standard do ERP. Cumprimentos, Miguel Vaz
    1 year and 3 months ago
    miguelvaz-2
      0
      Private answer

      Para referência futura e porque pode ser útil para outros, parece-me que utilizando a API de consulta de um documento existente ou a API que permite obter os dados para um novo documento ({{apiUrl}}Vendas/Docs/PreencheDadosRelacionados/) consigo ver todos os campos disponíveis para serem utilizados na API. Nomeadamente o atributo "Matricula" e informação CargaDescarga.

      Vou testar este processo e validar se desta forma conseguimos avançar com a nossa integração.

      Entretanto, ao tentar testar esta API de criar documentos - {{apiUrl}}Vendas/Docs/CreateDocument/ - obtenho sempre uma resposta 200 - OK com o conteúdo (body) false. Nada é criado do lado do ERP. Presumo que algo esteja errado com o funcionamento elementar da API. O teste que fiz foi simplesmente o de criar uma factura usando o exemplo fornecido na documentação acima utilizando dados que me parecem válidos (clientes e series existentes no sistema).

      Alguém sabe o que se poderá tratar? Existe alguma forma de consultar algum LOG que permita verificar estas situações?

      Desde já agradeço a ajuda!

      Cumprimentos,

      Miguel Vaz

      Faça login para poder traduzir
      Marked as spam
      Created 1 year and 3 months ago miguelvaz-2
      miguelvaz-2 Iniciante
        0
        Private answer

        Boa tarde

        O método em causa tem algumas limitações ao nível dos campos que é possível passar, e que no seu caso na criação de documentos do tipo Guia possivelmente podem não funcionar. Assim proponho que se usem duas opções:

        1. Abrir um TK à primavera para conseguir resposta.
        2. Usar o mecanismo de extensibilidade da WebAPI.

        Neste momento não consigo ajudar mais.

         

        Faça login para poder traduzir
        Marked as spam
        Created 1 year and 3 months ago sergiosereno
        sergiosereno Most Valuable Professional
          Comments
          Obrigado pela ajuda Sérgio! Como sou apenas integrador e tenho poucos conhecimentos sobre o primavera as suas APIs ou capacidade de o extender. Haverá outra API que eu não esteja a ver na documentação (postman) que seja mais adequada para este objectivo? Vou continuar à procura de apoio e tentarei o contacto com a Primavera caso continue a não encontrar a informação. Obrigado!
          1 year and 3 months ago
          miguelvaz-2