Faturação Eletrónica (CIUS-PT)

EDI (Electronic Data Interchange) é a troca eletrónica de documentos entre entidades através de um intermediário — o broker — que, além de entregar o documento, certifica o envio e a receção. A CIUS-PT é a especificação portuguesa da norma europeia CIUS para faturas em ficheiro estruturado (XML), e é o formato usado quando fatura eletronicamente em Portugal.

Importante

A obrigatoriedade legal do CIUS-PT aplica-se apenas à venda a entidades do setor público (B2G). Entre empresas (B2B) o formato é tecnicamente suportado mas a sua utilização é opcional.

Não existe um broker único em Portugal: cada entidade pública escolhe o seu. A Exo tem integração implementada com a Saphety — entretanto adquirida pela Sovos, pelo que a interface do produto apresenta as duas designações — e com a Generix. Para alcançar destinatários servidos por outro broker, estas contratam diretamente a abertura de interligação — um valor por interligação, pagamento único, não por destinatário nem recorrente. A este acresce a avença do broker, e é este custo recorrente — não o de implementação — que justifica optar pela via manual descrita mais abaixo para um volume esporádico de faturas B2G.

Nota

A negociação e o pagamento destes valores são matéria entre a sua empresa e a Saphety; valores indicativos, alteráveis unilateralmente pela Saphety.

A solução é composta por quatro módulos, com um único fluxo: a base gera e valida o ficheiro CIUS-PT; o de broker (Saphety ou Generix) acrescenta-lhe a transmissão ao broker; o de vendas acrescenta captura a montante, na encomenda.

Módulo

O que acrescenta

Depende de

Portugal - E-invoicing CIUS-PT

Geração e validação do ficheiro CIUS-PT na fatura e nota de crédito. Funciona sozinho.

—

Portugal - Saphety EDI

Transmissão ao broker, no envio da fatura, e acompanhamento do estado de entrega.

E-invoicing CIUS-PT

Portugal - Generix EDI

Transmissão à Generix, no envio da fatura, e acompanhamento do estado de entrega.

E-invoicing CIUS-PT

Portugal - Sales B2G and EDI

Campos B2G na encomenda de venda, com propagação para a fatura.

E-invoicing CIUS-PT e Vendas PT+

Os quatro módulos fazem parte da sua subscrição PT+ e não exigem pedido à Exo Software: ativam-se diretamente nas definições, tal como qualquer outra funcionalidade da localização.

Aviso

A comunicação em CIUS-PT cobre exclusivamente faturas e notas de crédito, e apenas no sentido da venda. Guias de remessa, encomendas a fornecedores, receção de documentos e o intercâmbio típico do retalho B2B não estão cobertos por esta solução. Se precisar de um destes cenários, contacte a Exo Software para avaliação em sede de implementação.

─── ✦ ───

Configurações

Ativação dos módulos

Aceda à app Faturação / Contabilidade (dependendo respetivamente se tem versão Community ou Enterprise do Odoo), vá ao menu Configuração ‣ Configurações e na secção Portugal ative a opção Faturação Eletrónica. Se pretender transmitir as faturas via Saphety, ative também a opção Broker EDI Saphety; via Generix, a opção Generix EDI broker. Ambas ficam disponíveis na mesma secção assim que a opção anterior está ativa.

../../_images/v19_edi_settings.png

Nota

Cada uma destas opções instala o respetivo módulo. A Portugal - Sales B2G and EDI não aparece aqui — instala-se sozinha assim que a E-invoicing CIUS-PT e as Vendas PT+ estão presentes.

Dica

A secção Portugal expõe ainda a opção Desativar Validação do Esquema, apenas em modo de programador e apenas com o backend de certificação em modo Testes. Serve para publicar faturas apesar de a validação do ficheiro CIUS-PT falhar — não recomendado fora de um ambiente de testes.

Credenciais do broker

Com a opção Broker EDI Saphety ativa, preencha o Nome de Utilizador e a Palavra-passe da conta Saphety da sua empresa, na mesma secção Portugal das definições — campos assinalados a azul na imagem acima — e guarde.

Com a opção Generix EDI broker ativa, o procedimento é o mesmo: preencha o Username e a Password da conta Generix da sua empresa, logo abaixo da opção, e guarde.

../../_images/v19_edi_settings_generix.png

Ações agendadas

A transmissão ao broker e o acompanhamento do estado usam duas ações agendadas. Para as ver, ative o modo de programador e abra Definições ‣ Técnico ‣ Automação ‣ Ações Agendadas.

../../_images/v18_edi_crons_list.png

Ação agendada

O que faz

Execução por omissão

PT EDI: Enviar faturas eletrónicas agendadas

Transmite ao broker as faturas eletrónicas que aguardam o envio agendado. Só tem efeito com a opção Envio agendado ativa.

Uma vez por dia, à noite (21h00 UTC).

EDI : Realizar operações de serviços web

Consulta o broker e atualiza o estado dos documentos enviados. Consulte Atualização do estado dos documentos.

Uma vez por dia.

Nota

O Odoo instala a ação EDI : Realizar operações de serviços web desativada. A instalação da Saphety EDI ou da Generix EDI ativa-a. Se o estado dos documentos não muda, confirme que a ação tem o campo Ativo ligado.

Envio agendado

Por omissão, o Odoo transmite a fatura eletrónica ao broker quando envia a fatura. Para transmitir todas as faturas eletrónicas de uma vez, a uma hora fixa, ative o envio agendado:

  1. Em Configuração ‣ Configurações, secção Portugal, marque a opção Envio Agendado de Faturas Eletrónicas, por baixo de Faturação Eletrónica.

  2. Clique em Guardar.

  3. Clique em Definir a hora de envio. O Odoo abre a ação agendada PT EDI: Enviar faturas eletrónicas agendadas.

../../_images/v18_edi_scheduled_sending_settings.png

Na ação agendada, defina quando o Odoo envia as faturas:

  1. No campo Próxima Data de Execução, defina o dia e a hora do próximo envio.

  2. No campo Executar a Cada, defina o intervalo entre dois envios.

  3. Guarde.

../../_images/v18_edi_scheduled_sending_cron.png

Nota

A opção é definida por empresa. A ação agendada é comum a todas as empresas da base de dados: a hora de envio é a mesma para todas.

Dica

Para enviar de imediato as faturas que aguardam, abra a ação agendada e clique em Executar Manualmente.

Formato do parceiro e herança

Indique, na ficha de cada parceiro cliente, que este deve receber faturas em CIUS-PT. Abra a ficha do parceiro, separador Contabilidade, e na secção Faturas a Clientes defina o campo Formato da fatura eletrónica como Portugal (CIUS-PT).

../../_images/v19_edi_partner_format.png

Nota

O campo só é visível em modo de programador. Para o ativar, clique no ícone de inseto no canto superior direito ou adicione ?debug=1 ao endereço da página.

Importante

Esta definição faz-se no parceiro principal e é herdada automaticamente por todos os seus contactos filhos — não precisa de a repetir por delegação, departamento ou morada de entrega. Para um contacto individual associado a uma empresa esta herança não é sequer visível na interface: o Odoo esconde o separador de faturação nesse caso, por não ser normalmente esse contacto a ser faturado. A definição no parceiro principal é o suficiente e aplica-se de forma transparente sempre que um documento é emitido para qualquer um dos seus contactos.

GLN do cliente e do local de entrega (Generix)

Alguns clientes com várias lojas, por exemplo cadeias de retalho, identificam cada loja e cada local de entrega pelo seu GLN (Global Location Number). Com a Generix EDI instalada, o campo GLN fica visível em todos os contactos:

  1. Abra a ficha do contacto: a loja que usa como cliente nas faturas, ou a morada de entrega.

  2. No separador Vendas e Compras, secção Diversos, preencha o campo GLN.

  3. Guarde a ficha.

../../_images/v18_edi_partner_buyer_gln.png

O campo também aparece no formulário de cada contacto, no separador Endereços e contactos da ficha do parceiro principal.

O ficheiro CIUS-PT usa o GLN de dois contactos da fatura:

Contacto da fatura

O que o GLN identifica no ficheiro CIUS-PT

Cliente

O comprador. Sem GLN, o ficheiro identifica o comprador pela Referência do parceiro principal.

Morada de entrega

O local de entrega.

Se a fatura não tiver morada de entrega, o Odoo usa o cliente como local de entrega. Nesse caso, o mesmo GLN identifica o comprador e o local de entrega.

Importante

Ao contrário do formato da fatura eletrónica, o GLN não é herdado do parceiro principal. Preencha-o em cada contacto que usa nas faturas, como cliente ou como morada de entrega. O GLN do parceiro principal só é usado nas faturas emitidas ao próprio parceiro principal.

Verificação prévia do destinatário

Antes de faturar, confirme que o NIF do parceiro está registado na plataforma Saphety: na ficha do parceiro, ao lado do campo NIF, o botão Check Sovos/Saphety consulta a plataforma e mostra o resultado — verde se o parceiro está apto a receber faturas via Saphety, vermelho caso contrário.

../../_images/v19_edi_partner_saphety_check.png

Se usar a Generix, a verificação é a mesma, através do botão Check Generix, no mesmo sítio. A consulta só é feita quando o campo Envio de faturas do parceiro está definido como pela Generix e as credenciais Generix estão preenchidas nas definições.

Importante

Trate esta verificação como pré-condição do fluxo, não como funcionalidade acessória: um NIF não registado no broker (Saphety ou Generix) impede a entrega mesmo com o ficheiro CIUS-PT correto.

Utilização

O fluxo é único; as variações introduzidas por cada módulo estão assinaladas nos pontos em que divergem.

Publicação e validação

O CIUS-PT impõe regras de conteúdo além das regras legais da fatura. Essa validação corre na publicação: se falhar, a fatura não é publicada e os erros detetados são apresentados para correção.

Importante

Este comportamento é deliberado e evita ter de anular e reemitir faturas já publicadas: a contrapartida é um ligeiro aumento do tempo de publicação, não uma limitação do sistema.

O ficheiro XML CIUS-PT é gerado nesse mesmo momento — não no envio — e a sua representação visual é incluída no PDF da fatura, pelo que não precisa de transmitir o PDF em separado.

Via manual, sem broker

Sem o módulo de broker instalado, ou para um volume esporádico que não justifique a avença descrita no início desta página, descarregue o ficheiro CIUS-PT e submeta-o você mesmo no portal da Saphety — serviço normalmente prestado sem custo para submissão avulsa.

O ficheiro fica disponível nos anexos da fatura publicada, no painel Ficheiros do registo de atividade (ícone de clip no canto superior direito):

../../_images/v19_edi_invoice_attachment.png

Descarregue-o a partir daí e submeta-o no portal do broker escolhido.

Via broker (Saphety ou Generix)

Com a Saphety EDI ou a Generix EDI instalada e configurada, a publicação da fatura não transmite o ficheiro CIUS-PT ao broker. A transmissão só acontece quando envia a fatura:

  1. Abra a fatura publicada e clique em Enviar.

  2. Na janela de envio, selecione pela Saphety ou pela Generix.

  3. Clique em Enviar para confirmar.

../../_images/v19_edi_send_wizard_generix.png

Se não selecionar uma destas opções, o Odoo não envia o ficheiro ao broker. Com o Envio agendado ativo, o Odoo transmite o ficheiro mais tarde, na hora definida.

Dica

Defina o campo Envio de faturas do parceiro como pela Saphety ou pela Generix. Assim, a janela de envio mostra essa opção já selecionada para as faturas desse parceiro.

Com o envio agendado ativo

Com a opção Envio Agendado de Faturas Eletrónicas ativa, o botão Enviar não transmite o ficheiro CIUS-PT. A fatura fica a aguardar pela ação agendada PT EDI: Enviar faturas eletrónicas agendadas:

  • No topo da fatura, o Odoo mostra a mensagem Esta fatura eletrónica será enviada pela Saphety na próxima execução do envio agendado (ou pela Generix).

  • Na lista de faturas, o filtro Fatura eletrónica agendada mostra todas as faturas que aguardam.

  • Não pode enviar outra vez uma fatura que aguarda. Se tentar, o Odoo mostra o erro O CIUS-PT já está agendado para envio e não pode ser enviado novamente.

Na hora definida, a ação agendada transmite as faturas por ordem de data e de número. A ação só transmite faturas publicadas: uma fatura anulada antes dessa hora não é transmitida.

Se a transmissão de uma fatura falha (por exemplo, o broker não responde), as outras faturas são transmitidas na mesma. A fatura com falha continua a aguardar e a ação tenta outra vez na execução seguinte. O motivo da falha fica no histórico da fatura, com a mensagem O envio agendado da fatura eletrónica falhou e será tentado novamente na próxima execução.

Atualização do estado dos documentos

Depois da transmissão, o broker processa o documento de forma assíncrona. Não espere ver o estado final logo após o envio: é o comportamento esperado, não uma falha.

A ação agendada EDI : Realizar operações de serviços web consulta o broker e atualiza o estado. Em cada execução, para cada documento com o estado da submissão Em Espera ou Em Curso:

  1. A ação consulta o estado do pedido de entrega e atualiza a coluna do estado da submissão.

  2. Quando o broker devolve o identificador do documento, a ação consulta também o estado do documento na plataforma do broker (por exemplo, Received).

  3. Quando o broker devolve erros, a ação mostra-os na fatura, no separador Documentos EDI.

Quando o estado da submissão passa a Concluído ou Erro, a ação deixa de consultar esse documento.

Dica

Por omissão, a ação corre uma vez por dia. Uma fatura transmitida à noite pelo envio agendado só mostra o estado novo na execução seguinte desta ação. Para atualizar os estados mais vezes, diminua o intervalo no campo Executar a Cada da ação (por exemplo, 1 hora). Para atualizar de imediato, clique em Executar Manualmente.

Estados na fatura

Depois de a fatura ser transmitida ao broker, o separador Documentos EDI da fatura mostra o estado do documento CIUS-PT:

../../_images/v19_edi_invoice_edi_tab.png

Coluna

Descrição

Estado

Estado do próprio ficheiro CIUS-PT (por exemplo, Enviado).

Estado da Submissão Saphety

Estado do pedido de entrega junto da Saphety: Em Espera, Em Curso, Erro ou Concluído.

Estado do Documento Saphety

Estado devolvido pela própria plataforma Saphety (por exemplo, Received) — texto apresentado tal como a Saphety o devolve, sem tradução.

Com a Generix, a lógica é a mesma e as colunas equivalentes são Generix Request Status (Queued, Running, Error ou Finished) e Generix Document Status (por exemplo, Received).

Dica

Se a coluna Estado da Submissão Saphety (ou Generix Request Status) indicar Erro, verifique o NIF do parceiro e as credenciais do broker nas definições, e reenvie a fatura.

Campos para faturação a entidades públicas (B2G)

Os campos Nº do Compromisso e Nº do Cabimento, exigidos na contratação pública portuguesa, existem na fatura com a app base instalada e podem ser preenchidos manualmente no separador Outra Informação.

../../_images/v19_edi_invoice_b2g_fields.png

Com o módulo Portugal - Sales B2G and EDI instalado, estes mesmos campos ficam também disponíveis na encomenda de venda, no separador Outra Informação, secção Faturação:

../../_images/v19_edi_sale_order_b2g_fields.png

Dica

Os campos só aparecem em encomendas às quais já esteja associado um Tipo de Documento Fiscal português (Série Documental) — antes disso o Odoo não trata a encomenda como um documento fiscal PT e os campos ficam ocultos.

Ao criar a fatura a partir dessa encomenda, os valores propagam-se automaticamente e ficam igualmente visíveis no separador Outra Informação da fatura. Quando preenchidos, são incluídos no XML CIUS-PT e impressos no PDF de ambos os documentos, encomenda e fatura:

../../_images/v19_edi_sale_order_pdf_b2g.png

Acompanhamento e resolução de erros

Conformidade não garante aceitação

Uma fatura conforme ao CIUS-PT pode ser aceite pelo broker e ainda assim recusada pelo destinatário, porque entidades públicas impõem por vezes regras próprias além do formato — por exemplo, algumas exigem referências Multibanco, que o CIUS-PT prevê mas não torna obrigatórias.

Importante

Este é o cenário de erro mais provável em produção: a fatura fica publicada, transmitida com sucesso, e é recusada pelo destinatário dias depois. Quando isso acontece, a fatura emitida não é corrigível — tem de ser anulada, duplicada e reemitida com a correção necessária.

Erros de submissão

Um erro no estado de submissão (coluna Estado da Submissão Saphety ou Generix Request Status a Erro) remete quase sempre para o NIF do parceiro ou para as credenciais do broker na empresa. Confirme ambos — usando o botão Check Sovos/Saphety ou Check Generix na ficha do parceiro — e reenvie a fatura.