Erro ao submeter pedido à API do Gestix ERP

Questão

Estamos a ter dificuldades com os movimentos de transferencia através da API com a seguinte mensagem de erro: “Erro Gestix: 400 Gestix: document data not valid | entity not found in API (.items). No items data received. 2023-12-28 16:38:23 (login: Test company: iServices, lda.)”

Segundo conseguimos apurar, são caracteres incomuns como os que coloco abaixo na foto que estão na origem do erro. Conseguem ajudar?

Resposta

Recapitulando o processo de envio de dados para o Gestix através da API, a vossa aplicação deve

1º formar o JSON que encapsula esses dados
2º submeter o JSON à API
3º escutar o retorno da API

O retorno que obtém no passo 3º indica que o JSON formado pela vossa fonte de dados no passo 1º não é válido. Para ser mais fácil aos vossos engenheiros encontrarem o problema na fonte dos dados podem “pegar” nesse JSON gerado no 1º passo e submete-lo manualmente num validador on-line. Assim, o validador vai indicar quando o JSON estiver isento de erros.

Exemplo de um validador JSON online pode ser encontrado no seguinte link: https://jsonlint.com/

Fatura Eletrónica

A partir de 1 de janeiro de 2024 a fatura eletrónica passa a ser obrigatória para as micro, pequenas e médias empresas, no âmbito da execução de contratos públicos, os cocontratantes são obrigados a emitir faturas eletrónicas, sem prejuízo dos requisitos exigidos na legislação fiscal.
Os cocontratantes podem ser entidades privadas ou publicas, desde que ajam como fornecedores da Administração Publica (AP) na execução de contratos públicos.

Embora a faturação eletrónica B2G (Business-to-Government) se tenha tornado obrigatória a 1 de janeiro de 2023, o Decreto-Lei n.º 54/2023, publicado a 14 de julho de 2023, veio adiar mais uma vez esta obrigatoriedade para 31 de dezembro de 2023.

O governo português tem vindo a introduzir a obrigatoriedade da fatura eletrónica B2G nos últimos anos, a par de outras obrigações para a digitalização do cumprimento do IVA no país, alinhado com os esforços da União Europeia no sentido de harmonizar a adoção da fatura eletrónica nos contratos públicos.

Para atingir este objetivo, a UE implementou a Diretiva 2014/55/UE de forma a definir as responsabilidades e os critérios de faturação eletrónica nos processos de contratação pública. A UE exige que os Estados-Membros imponham a obrigação de a AP receber as faturas por via eletrónica.

Em que consiste a Faturação Eletrónica para a Administração Pública?

A Fatura Eletrónica é emitida, transmitida e recebida num formato eletrónico, com a informação devidamente estruturada para permitir o seu tratamento de forma automática. Uma fatura em formato pdf deixa de ser considerada fatura eletrónica.

Todas as entidades adjudicantes públicas devem de ser capazes de receber e processar faturas eletrónicas de remetentes nacionais e estrangeiros.

Soluções disponíveis para Fatura Eletrónica

Fatura Eletrónica/EDI ( Electronic Data Interchange ) – esta solução permite transmitir eletrónicamente dados estruturados entre entidades. Isto é, permite que a fatura (ou documentos com relevância fiscal) gerada num dispositivo, seja recebida e importada de maneira correta e automáticamente noutros dispositivo

Fatura em PDF – às faturas PDF utilizadas atualmente vai ser necessário inserir uma assinatura digital qualificada, que vai servir para confirmar a autoria do documento em formato eletrónico.

Vantagens da Fatura Eletrónica

  • Redução de custos evita custos administrativos, perdas de tempo no processamento de documentos e gastos em papel, tinteiros e no envio das faturas pelos CTT ;
  • Visibilidade e garantia de entrega, visibilidade sobre os diferentes estados da fatura e confirmação da receção pelo cliente
  • Mais transparência na relação entre clientes e fornecedores, otimizando tempos de processamento, conferência, aprovação de faturas e pagamentos
  • Mais lucros, a entrega imediata de faturas permite diminuir o prazo de pagamento, melhorando a liquidez das empresas.

Para qualquer esclarecimento de dúvidas contate-nos através do nosso e-mail: info@gestix.pt

News Gestix ERP November

  • Offer Voucher at Point of Sale and in Billing with POS
  • In the Global View, show the Net of VAT in the analytical summary
  • Customs Code – New optional column per document line
  • Correction of difficulty that existed when entering a Postage value, which did not immediately assume the respective VAT rate
  • New JEDI Electronic Invoice (JSON EDI) option for direct integration of documents between companies using Gestix ERP
  • Project Profit Margin was not accurate when partial credit notes were involved
  • Document Series ID with up to 15 alphanumeric characters
  • User-configured buttons on the Point of Sale/Touch Screen POS did not assume price at the time of sale
  • By updating item stock via CSV, it allows multiple operators to work in different stores or warehouses
  • When importing customer databases via CSV, ignore incomplete records but continue importing the data
  • Allow changing the payment method in Invoices/Receipts and Receipts if the operator has System Administration privileges, even if the document has already been printed

Gestix ERP Noviembre

  • Bono de Oferta en Punto de Venta y en Facturación con POS
  • En la Vista Global, mostrar el Neto de IVA en el resumen analítico
  • Código Aduanero – Nueva columna opcional por línea del documento
  • Corrección de dificultad que existía al ingresar un valor de Envío, que no asumía inmediatamente la tasa de IVA respectiva
  • Nueva opción JEDI Electronic Factura (JSON EDI) para la integración directa de documentos entre empresas utilizando Gestix ERP
  • El margen de beneficio del proyecto no era exacto cuando se trataba de notas de crédito parciales
  • ID de serie de documentos con hasta 15 caracteres alfanuméricos
  • Los botones configurados por el usuario en el punto de venta/POS con pantalla táctil no asumían el precio en el momento de la venta
  • Al actualizar el stock de artículos a través de CSV, permite que varios operadores trabajen en diferentes tiendas o almacenes.
  • Al importar bases de datos de clientes a través de CSV, ignore los registros incompletos pero continúe importando los datos
  • Permitir cambiar el método de pago en Facturas/Recibos y Recibos si el operador tiene privilegios de Administración del Sistema, incluso si el documento ya ha sido impreso

Actualités Gestix ERP Novembre

  • Offrez un bon au point de vente et dans la facturation avec le point de vente
  • Dans la Vue Globale, affichez le Net de TVA dans la synthèse analytique
  • Code des douanes – Nouvelle colonne facultative par ligne de document
  • Correction d’une difficulté qui existait lors de la saisie d’une valeur de port, qui n’assumait pas immédiatement le taux de TVA respectif
  • Nouvelle option JEDI Electronic Invoice (JSON EDI) pour l’intégration directe de documents entre entreprises utilisant Gestix ERP
  • La marge bénéficiaire du projet n’était pas exacte lorsque des notes de crédit partielles étaient impliquées
  • ID de série de documents comportant jusqu’à 15 caractères alphanumériques
  • Les boutons configurés par l’utilisateur sur le point de vente/POS à écran tactile n’assumaient pas le prix au moment de la vente.
  • En mettant à jour le stock d’articles via CSV, il permet à plusieurs opérateurs de travailler dans différents magasins ou entrepôts
  • Lors de l’importation de bases de données clients via CSV, ignorez les enregistrements incomplets mais poursuivez l’importation des données
  • Autoriser la modification du mode de paiement dans Factures/Reçus et Reçus si l’opérateur dispose des privilèges d’administration système, même si le document a déjà été imprimé

Novidades Gestix ERP

  • A implementação da assinatura digital do PDF no Gestix é transparente para o Utilizador que subscreva o respetivo serviço. O PDF é assinado tanto quando é enviado por email como quando é descarregado para ficheiro. Para verificar os detalhes do selo digital do PDF, abrir o PDF com o Adobe Acrobat Reader e abrir a opção “Verificar Painel de Assinaturas”
  • Novo modo de configuração da Série de Documentos “apenas para consulta” https://blog.gestixsoftware.com/2024/01/series-de-documentos-apenas-para-leitura/
  • Talão de Oferta no Ponto de Venda e em Faturação com POS
  • Na Visão Global mostrar o Líquido de IVA no resumo analítico
  • Código Aduaneiro – Nova coluna opcional por linha de documento
  • Correção de dificuldade que existia ao inserir um valor de Portes, não assumia de imediato a respetiva taxa de IVA
  • Nova opção de Fatura Eletrónica JEDI (JSON EDI) para integração direta de documentos entre empresas que utilizam Gestix ERP
  • Margem de Lucro por Projeto não era exata quando havia notas de crédito parcelares envolvidas
  • ID de Séries de Documentos com até 15 carateres alfanuméricos
  • Botões configurados pelo utilizador no Ponto de Venda/POS Ecrã Tátil não assumiam preço no momento da venda
  • Ao atualizar stock de artigos por CSV permitir múltiplos operadores a trabalhar em diferentes lojas ou armazéns
  • Ao importar bases de dados de clientes por CSV ignorar fichas incompletas mas prosseguir importação dos dados
  • Permitir alterar o meio de pagamento em Faturas/Recibo e Recibos se o operador tiver privilégios de Administração do Sistema, mesmo que o documento já tenha sido imprimido

Novidades Gestix ERP Outono 2023

Séries de Documentos

Ao criar novas séries de numeração de faturas ou quaisquer outros tipos de documentos dispõe agora de até 15 carateres para o código da Série. Exemplo: FAT2024 1234

Fatura Eletrónica/EDI para Administração Pública e Entidades Privadas

Se o seu cliente requer Fatura Eletrónica/EDI para que esta seja lançada automaticamente no seu sistema, o Gestix Enterprise oferece o desenvolvimento necessário para se ligar ao interface apropriado através da Saphety Invoice Network (SIN). Aceite o nosso convite para se registar no SIN e simplifique este processo, adquire os créditos em documentos EDI a enviar de forma completamente automática e integrada no seu Gestix ERP, à medida das suas necessidades mensais ou anuais.

PDF com Assinatura Digital Qualificada

A partir de 2024, para enviar faturas e outros documentos por via eletrónica (mail, whatsapp, etc) deverá fazê-lo utilizando PDF com Selo Digital Certificado no nome de pessoa qualificada para assinar em nome da sua empresa. O seu Gestix simplifica este processo. Aceite o nosso convite para se registar no SIN e obtém o pacote de assinaturas digitais qualificadas para as necessidades anuais da sua atividade. Caso entregue sempre faturas em papel ao seu cliente, não precisa de subscrever este serviço.

No caso de entregar sempre ao seu cliente faturas em papel, não precisa desta tecnologia.

Pagamento Online do seu Serviço Gestix Cloud

Em breve poderá realizar o pagamento online do seu serviço Gestix Cloud para maior comodidade. Assim, deixa de depender da Fatura Proforma para poder renovar a sua licença Gestix Cloud. Poderá também subscrever outros serviços ou upgrades se necessário.

Gestão Clínica Simplificada

O Gestix é fácil de adaptar à gestão da clínica.

O registo do cliente pode ser feito no menu Clientes, antecipadamente, ou no menu Faturação, ao fazer a Fatura.

No menu Clientes é possível aceder e editar todos os dados gerais e pessoais da entidade, bem como eventuais notas e observações.

Registo de Tarefas no menu Tarefas

Após o registo do cliente no Gestix podem ser registadas tarefas ou ações, que consistem numa descrição, data de início da tarefa (Data Limite), e data opcional para alerta do utilizador.

Registar uma Tarefa (Realizada ou Agendada)

  • Escolher Tarefas no menu lateral
  • clicar no botão + para adicionar

É apresentada uma ficha de Tarefa para preenchimento manual.

Dados da Tarefa

  • Originada – Utilizador e Data de registo da Tarefa
  • P/Utilizador – Utilizador a quem a Tarefa se destina
  • Data Limite – Data em que a Tarefa é realizada (por omissão é a data de de registo da Tarefa)
  • Cliente – ao qual a Tarefa fica associada
  • Tipo de Tarefa – Um dos tipos definidos pelo Utilizador no menu Tarefas ^ Tipos de Tarefa
  • Descrição – da Tarefa realizada ou a realizar
  • Tarefa Completada – deixar em branco no caso de agendamento de Tarefa, marcar com visto se ou quando a Tarefa estiver concluída
  • Notas – pode ser usado para registar informação sobre a tarefa ou ação realizada
  • Situação (texto) – descrição livre sobre a situação em que a Tarefa se encontra
  • Situação (data) data em que a situação da Tarefa é avaliada
  • Alertar Em – colocar um visto quando for pretendido o alerta do utilizador bem como a respetiva data/hora no campo adjacente
  • Próximo Contacto – data de caráter informativo, opcional

Ao clicar Cliente é mostrada a lista dos clientes recentemente acessados. Clicar em Procurar para poder pesquisar por nome ou outros dados.


Ao clicar em Procurar é aberta uma janela que permite inserir o número do cliente (ID) ou parte do nome. Ao clicar na “lupa” é atualizada a lista com os eventuais resultados.

Para o utilizador ser alertado sobre a tarefa, ao entrar no seu Gestix, colocar um pisco no campo Alertar Em e selecionar a data do aviso.

Após inseridos os dados da Tarefa, clicar em Gravar. A adição de anexos a uma Tarefa (imagens, documentos) fica acessível após gravada.

O menu Tarefas apresenta a lista de Tarefas bem como alguns campos para filtrar a informação a apresentar.

Lista de Tarefas – Filtros

  • Utilizador – permite mostrar apenas Tarefas referentes a um dado utilizador, ou a todos
  • Tarefa Completada – Permite mostrar apenas Tarefas concluídas (opção Sim), apenas Tarefas agendadas (opção Não), ou todas.
  • Tipo de Tarefa – permite mostrar apenas Tarefas de uma dada tipologia, ou de todas.
  • Data Entre / E – permite restringir a lista de Tarefas às registadas ou devidas no período entre as duas datas inseridas (inclusive).
  • Filtro – permite inserir um texto a procurar na Descrição da Tarefa
  • Atualizar – aplica os filtros e apresenta a lista de Tarefas que satisfazem todas as condições

Consultar ou Editar Tarefa

No menu Tarefas, para consultar, editar ou eliminar uma Tarefa, primeiro verificar os Filtros e clicar Atualizar para mostrar a tarefa na lista, seguidamente clicar na Tarefa para aceder ao dados da mesma.

Os dados da Tarefa podem ser editados, sendo necessário depois clicar em Gravar (no topo do ecrã). Para eliminar a Tarefa clicar em Apagar.

Para adicionar um Anexo à Tarefa clicar no botão Escolher Ficheiro e selecionar a imagem ou PDF a arquivar no seu Gestix Cloud. Após inserido, poderá repetir o processo para adicionar mais anexos.

A lista de Anexos é apresentada com um olho e um X. O olho permite visualizar ou descarregar o anexo, o X permite remover o ficheiro do servidor.

Configuração inicial dos Tipos de Tarefa

Antes de começar a inserir Tarefas é conveniente aceder ao menu Tipos de Tarefa no topo do menu Tarefas (listagem), e adicionar as tipologias relevantes para a atividade. Os Tipos de Tarefa restantes, que não façam sentido, devem ser eliminadas.

Para adicionar um Tipo de Tarefa, clicar no botão +
Para consultar, editar ou eliminar, clicar na lista de Tipos de Tarefa e acionar uma das opções do menu no topo do ecrã.

Atributos de Clientes (tags)

Atributos são campos definidos pelo Utilizador para ajudar a classificar o Cliente e extrair relatórios. Antes de começar a registar dados de Clientes no sistema é conveniente rever a configuração criada automaticamente pela aplicação.

O menu Atributos, no topo, permite configurar este setor da aplicação.
Entre os Atributos definidos, aqueles que tiver a opção “Disponível para Critério de Listagem” são apresentados no menu Clientes para restringir a listagem de acordo com a seleção de cada atributo.

Para tal, no menu Clientes ^ Atributos, inserir as Tags que façam sentido para a atividade, como por exemplo, “Dono”, “Tratador”, “Associação”, “Cães”, “Gatos”, “Roedores”, etc.

Clicar no + para adicionar atributos.

  • Nome Atributo – o texto breve da “Tag”
  • Tipo – de visibilidade deste Atributo na aplicação
    • Informação – complementa dados do cliente
    • Disponível no POS – complementa dados do cliente e fica disponível no Ponto de Venda para ser editado pelo operador
    • Disponível para Critério de Listagem – complementa os dados do cliente e fica disponível para filtrar a listagem de cliente por um ou mais Atributos em simultâneo.
  • Marcado Por Defeito – colocar um visto caso se pretenda que este Atributo seja automaticamente ativado ao criar uma ficha de cliente

Clicar na lista para consultar, alterar ou eliminar o item.

Ao entrar na ficha do item é mostrado o menu no topo que permitem alterar, eliminar ou duplicar o Atributo.

É recomendado eliminar os atributos criados automaticamente pela aplicação e que não façam sentido para a atividade.

Consulta de Tarefas no menu Clientes

É possível aceder às Tarefas a partir da ficha do Cliente. Após selecionada a ficha do Cliente, o separador Tarefas permite aceder às Tarefas daquela entidade.

Notas

  • Está disponível API (Interface de Programação Aplicacional) para integração com aplicações ou dispositivos externos, permitindo a automação do registo de Tarefas/Agendamentos, entre outros.
  • A adição de Anexos é uma funcionalidade opcional.

Tabela de Motivos de Isenção de IVA 2023

As alterações ao nível da tabela de motivos de isenção de IVA, descritas no seguinte quadro, estão refletidas no Gestix ERP de forma a permitr ao Utilizador justificar as transações isentas de IVA de acordo com a prescrição legal aplicável.

https://paulomarques-saberfazer-fazersaber.blogs.sapo.pt/novos-motivos-de-isencao-ou-de-nao-71514

Cortesia Paulo Marques (https://paulomarques-saberfazer-fazersaber.blogs.sapo.pt/), via Odélia Alves (C. C.)

Em caso de dúvida sobre o código exato a adotar em cada caso, o Utilizador deverá contactar o seu Contabilista Certificado ou a Autoridade Fiscal.

No menu Gestix Admin | Taxas de IVA, o detalhe da taxa 0 (Isento de IVA) deixa de ser editável (empresas sediadas em Portugal), apresentando sempre a tabela atualizada dos motivos de isenção de IVA cuja menção na fatura é obrigatória.

Serviços prestados via eletrónica a sujeitos passivos fora da União Europeia (e não só)

Apesar da operação não ser tributada em território nacional, subsiste a
obrigação, por parte de prestador de serviços, de emissão de factura, sob a
forma legal, com menção dos elementos a que se refere o n.º 5 do artigo
36.º do CIVA, designadamente do motivo justificativo da não aplicação de
imposto, mediante aposição do seguinte: “Operação não localizada no
território nacional ao abrigo da al. a), do n.º 6 do artigo 6.º do CIVA, à
contrario”.

M40 IVA Autoliquidação Art. 6º n.º 6 alínea a) do CIVA, a contrário

Fonte: http://taxfile.pt/file_bank/news2413_3_1.pdf

Transmissões Intracomunitárias de Bens (não por via eletrónica)

” a operação só estará isenta ao abrigo da alínea a) do art.° 14° do
RITI se o sujeito passivo, conforme esclarecido no Ofício-Circulado n° 30009,
de 1999.12.10, estiver na posse de qualquer um dos meios de prova ali
elencados. “

M16 Isento Artigo 14.º do RITI (ou similar)

Fonte: http://www.taxfile.pt/file_bank/news0212_26_1.pdf