Você está na página 1de 36

MANUAL DE INTEGRAO DE SOFTWARE

Comunicao das Faturas AT

Manual de Integrao de Software Comunicao das Faturas AT

HISTRICO DE ALTERAES
DATA
04-12-2012

ALTERAES
Corrigido exemplo de data de sistema que se deve incluir no Header de segurana dos pedidos SOAP. Quando a data se refere ao UTC deve terminar em Z e no em +00:00. Acrescentados os tamanhos mximos dos campos a incluir no CSR do pedido de adeso ao envio de dados de fatura por Webservice. O Webservice de envio de dados de fatura passou a ter como novo elemento obrigatrio o estado da fatura (InvoiceStatus) preenchido com N ou A. Reviso geral do documento incluindo a adio de informao de apoio ao processo de adaptao dos programas de faturao, clarificar a construo do pedido SOAP. Acrescentada mais informao no pedido de adeso e gerao do CSR. Includa informao sobre o registo direto no portal das finanas atravs de declarao mensal de faturas.

17-12-2012 26-12-2012

05-02-2013

Av. Eng. Duarte Pacheco, 28 - 18., Lisboa Email: portal-qt@at.gov.pt www.portaldasfinancas.gov.pt

Tel: (+351) 21 383 4200

Fax: (+351) 21 383 4646

Manual de Integrao de Software Comunicao das Faturas AT

NDICE
1 INTRODUO.................................................................................................................. 4 2 ENQUADRAMENTO .......................................................................................................... 5
2.1 Comunicao das Faturas por Webservice ........................................................................................................ 5 2.2 Comunicao das Faturas por SAF-T (PT) ......................................................................................................... 6 2.3 Registo direto das Faturas no Portal das Finanas ............................................................................................ 8

3 ADAPTAO DO SOFTWARE DE FATURAO .................................................................. 10


3.1 Comunicao por Webservice ........................................................................................................................... 10 3.2 Comunicao por SAF-T (PT) ........................................................................................................................... 16

4 ESTRUTURA DO PEDIDO SOAP ..................................................................................... 17


4.1 SOAP:Header .................................................................................................................................................... 18 4.2 SOAP:Body ........................................................................................................................................................ 21 4.3 Resposta ao pedido SOAP ................................................................................................................................ 27

5 ASSINATURA CERTIFICADO SSL (CSR)......................................................................... 28


5.1 Gerar um certificado SSL .................................................................................................................................. 31 5.2 Integrar certificado com a chave privada .......................................................................................................... 32

6 GLOSSRIO ................................................................................................................. 35

Av. Eng. Duarte Pacheco, 28 - 18., Lisboa Email: portal-qt@at.gov.pt www.portaldasfinancas.gov.pt

Tel: (+351) 21 383 4200

Fax: (+351) 21 383 4646

Manual de Integrao de Software Comunicao das Faturas AT

1 Introduo
O presente documento descreve os procedimentos e requisitos necessrios comunicao de dados das faturas Autoridade Tributria e Aduaneira, adiante designada por AT. Este documento destina-se a apoiar as empresas ou indivduos que desenvolvam e/ou comercializem software de faturao para os sujeitos passivos (seus clientes utilizadores do software produzido), doravante designados por produtores de software. Os produtores de software so responsveis por desenvolver programas que cumpram com os requisitos legais da comunicao de faturas e, para este efeito, devem guiar-se pelas especificaes produzidas pela AT para este efeito de comunicao. O Sujeito Passivo (tambm designado por comerciante) responsvel pelo envio e contedo da mensagem, uma vez que utiliza as suas credenciais no Portal das Finanas (Utilizador e Senha). Estas credenciais s podem ser conhecidas pelo Sujeito Passivo devendo o software produzido estar preparado para solicitar estas credencias, sempre que necessrio comunicao dos dados. Cada programa de faturao ou software identificado perante a AT atravs de um Certificado Digital emitido pelo produtor de software e assinado digitalmente pela AT atravs de processo de adeso disponvel no site e-fatura. A AT s aceita estabelecimento de comunicao de dados se o programa de faturao enviar no processo de comunicao, o Certificado Digital emitido para este efeito. Este certificado apenas garante o estabelecimento da comunicao sendo responsabilidade do produtor de software transmitir corretamente os dados dos Sujeitos Passivos, seus clientes, e que foram registados no programa de faturao.

5 de Fevereiro de 2013

4 / 36

Manual de Integrao de Software Comunicao das Faturas AT

2 Enquadramento
De acordo com o disposto no Artigo 3 do Decreto-Lei n. 198/2012 de 24 de agosto, os sujeitos passivos de IVA tm de comunicar as faturas emitida AT, por uma das seguintes vias: Por transmisso eletrnica em tempo real, integrada em programa de Faturao Eletrnica, utilizando o Webservice disponibilizado pela AT; Atravs do envio do ficheiro SAF-T (PT), exportado mensalmente pelo programa de faturao certificado e recorrendo a aplicao de envio de dados disponibilizada no site e-fatura no Portal das Finanas. Por recolha direta dos dados da fatura em opo do Portal das Finanas.

Da informao transmitida, sero registados os elementos identificativos dos intervenientes bem como os valores globais da transmisso de bens ou prestao de servios e do montante de IVA faturado.

2.1

Comunicao das Faturas por Webservice

Para efetuar a comunicao por Webservice, tal como disposto na alnea a) do n. 1 do Artigo 3. do Decreto-Lei n. 198/2012 de 24 de agosto, os programas de faturao tem que estar adaptados de forma a: 1. Respeitar o modelo de dados tal como previsto no n 4 do Artigo 3. do Decreto-Lei n. 198/2012 de 24 de agosto e definido em formato WSDL publicado no site e-fatura, na pgina dedicada aos produtores de software, ou em alternativa atravs do endereo: http://info.portaldasfinancas.gov.pt/NR/rdonlyres/02357996-29FC-4F11-9F1D6EA2B9210D60/0/factemiws.wsdl 2. Utilizar os protocolos de comunicao definidos para a transmisso de dados utilizando este servio, designadamente o protocolo SOAP: 3. Implementar os mecanismos de segurana na transmisso de dados que visam garantir a confidencialidade dos dados tal como disposto no Artigo 6. do Decreto-Lei n. 198/2012 de 24 de agosto, designadamente: a) Comunicao de dados atravs de canal HTTPS, com utilizao de certificado de identificao do produtor de software previamente assinado pela AT;

5 de Fevereiro de 2013

5 / 36

Manual de Integrao de Software Comunicao das Faturas AT

b) Encriptao da senha do utilizador do sujeito passivo no portal das finanas recorrendo a chave pblica (RS) do sistema de autenticao utilizado pelo Portal das Finanas na identificao dos seus utilizadores; c) Demais mecanismos definidos em detalhe neste documento para garantir a segurana da transmisso dos dados para a AT.

2.2

Comunicao das Faturas por SAF-T (PT)

Para comunicar os dados das faturas por ficheiro SAF-T (PT), cada sujeito passivo (comerciante) ter de proceder em dois passos: 1. Extrao do ficheiro mensal SAF-T (PT); 2. Envio do ficheiro no Portal das Finanas, site e-fatura.

2.2.1 Extrao do Ficheiro SAF-T (PT)


Em cada ms decorre a atividade comercial onde aps a transmisso do bem/prestao do servio, o fornecedor emite a fatura respeitando as regras legais vigentes. No incio do ms seguinte, o sujeito passivo (comerciante) extrai do seu sistema de faturao o ficheiro SAF-T (PT) para o efeito de comunicao AT das faturas emitidas no ms anterior. O ficheiro XML para este efeito deve conter as seguintes tabelas do SAF-T (PT) e os respetivos elementos definidos na estrutura de dados disponvel no seguinte endereo: http://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/NEWS_SAF-T_PT.htm 1 - Cabealho (Header); 2.2 - Tabela de Clientes (Customer); 2.5 - Tabela de Impostos (TaxTable); 4.1 - Documentos Comerciais de Clientes (SalesInvoice). Para efeitos de otimizao de envio do ficheiro, este deve conter apenas: Os Documentos Comerciais com data movimento do perodo em extrao (Ms, Dia); Os Clientes que tenham referncia nos Documentos Comerciais (deixando de fora os que no efetuaram transaes comerciais no perodo);

5 de Fevereiro de 2013

6 / 36

Manual de Integrao de Software Comunicao das Faturas AT

Dependendo do volume de faturas emitidas, a extrao e envio poder ser fracionada em perodos mais curtos, por exemplo, por semana ou por dia. Apenas para sujeitos passivos que emitem um nmero pequeno de faturas, sero aceites ficheiros SAF-T (PT) extrados de forma integral (nos termos do n. 1 do Anexo Portaria n. 1192/2009, de 8 de Outubro), ou seja ficheiros com mais tabelas que as atrs referidas. Salienta-se que o processamento destes ficheiros ser apenas para uma fase inicial prevendose a divulgao de data a partir da qual no sero mais aceites ficheiros SAF-T (PT) integrais.

2.2.2 Envio do Ficheiro SAF-T (PT) extrado


Na posse do ficheiro extrado, o sujeito passivo (comerciante) acede ao Portal das Finanas e ao site e-fatura: Escolhe a opo de Enviar Ficheiro disponvel na rea dos comerciantes; Ao escolher esta opo -lhe disponibilizado um formulrio para indicao do ficheiro a comunicar (unidade, caminho-da-diretoria-onde-est-guardado e nome.xml); note-se que a extenso do ficheiro ser obrigatoriamente .xml. Aps escolha do ficheiro este automaticamente validado, apresentando mensagens de erro no caso do ficheiro no estar em condies de ser submetido; Aps a correta validao do ficheiro apresentado um resumo estatstico do seu contedo e disponibilizada a opo de envio para a AT - Submeter; Ao submeter ser necessrio introduzir as credenciais (Utilizador e Senha) do Portal das Finanas referentes ao sujeito passivo (comerciante) responsvel pelo envio do ficheiro de faturas; Aps a completa transmisso do ficheiro para a AT mostrada uma mensagem de confirmao do envio.

Posteriormente, o ficheiro ser processado pela AT e, se o contedo for vlido, desse ficheiro sero extrados os elementos sumrios das faturas, que sero integrados na base de dados de faturas para os efeitos determinados na lei. Para seguimento do tratamento do ficheiro comunicado, o comerciante ter disponvel uma opo de consulta aos ficheiros SAF-T (PT) por ele submetidos AT. Sempre que comunique um ficheiro, o emissor dever posteriormente aceder a essa consulta e verificar se o ficheiro foi processado com Sucesso. As situaes de processamento previstas so:

5 de Fevereiro de 2013

7 / 36

Manual de Integrao de Software Comunicao das Faturas AT

Pendente - quando ainda espera processamento; Integrado com sucesso - quando o ficheiro foi totalmente processado e registado na base de dados da AT; Integrado parcialmente - quando s parte da informao foi processada, por exemplo a que difere da enviada anteriormente por este ou outro meio. Rejeitado - quando se detetou um problema a nvel de contedo que impediu o respetivo processamento.

2.3

Registo direto das Faturas no Portal das Finanas

A comunicao por esta via aplica-se aos sujeitos passivos definidos nos termos da Portaria n. 426-A/2012. O Artigo 2. desta portaria define a forma de comunicao das faturas para os sujeitos passivos que, cumulativamente: a) No sejam obrigados a possuir o ficheiro SAF -T (PT) da faturao, criado pela Portaria n. 321 -A/2007, de 26 de maro, alterada pela Portaria n. 1192/2009, de 8 de outubro e pela Portaria n. 382/2012, de 23 de novembro; b) No utilizem, nem sejam obrigados a possuir programa informtico de faturao, previsto na Portaria n. 363/2010, de 23 de junho, alterada pela Portaria n. 22 -A/2012, de 24 de janeiro; e c) No optem pela utilizao de qualquer dos meios de comunicao previstos nas alneas a) a c) do n. 1 do artigo 3. do Decreto -Lei n. 198/2012, de 24 de agosto. De acordo com os Artigos 3. a 6 desta portaria, e com as instrues na declarao, os sujeitos passivos ao abrigo desta forma de comunicao devem submeter mensalmente uma declarao onde: Indicam o NIF do sujeito passivo (emitente das faturas); O perodo, ano e ms de tributao; Na informao global: a primeira e ltima fatura de cada srie que possuam; o montante global de IVA; e o montante global das faturas do perodo;

5 de Fevereiro de 2013

8 / 36

Manual de Integrao de Software Comunicao das Faturas AT

Na informao parcial o detalhe de cada fatura, incluindo: o seu nmero; tipo de documento; data de emisso; NIF do adquirente; valor da fatura; valor do IVA includo.

Tambm esto previstos casos especiais durante um perodo transitrio que devem ser consultados no Artigo 7 da Portaria n. 426-A/2012.

5 de Fevereiro de 2013

9 / 36

Manual de Integrao de Software Comunicao das Faturas AT

3 Adaptao do software de faturao


Nesta seco a AT apresenta as suas recomendaes aos produtores de software de forma a mudarem os seus programas de faturao para inclurem o envio de faturas, uma a uma por Webservice ou para o envio de faturas por ficheiro SAF-T (PT).

3.1

Comunicao por Webservice

O envio de faturas por Webservice pressupe que este feito medida que as fatura so registadas no programa de faturao, estando associado ao conceito de comunicao em tempo real, ou seja, assim que o sujeito passivo regista um documento comercial (e.g., fatura) no programa este de imediato comunicada AT por este canal. Cada produtor de software responsvel por implementar o mdulo que vai enviar os documentos comerciais que, para alm dos requisitos gerais j enunciados na seco 2.1, dever respeitar os seguintes passos: 1. Sujeito passivo emite documento comercial no programa de faturao; 2. Programa de faturao solicita as credencias do sujeito passivo tal como definidas no portal das finanas e na gesto de subutilizadores: a) Cada sujeito passivo deve criar um subutilizador para o envio de dados de faturao em opo disponvel no Portal das Finanas na seco Servios tributrios/Outros servios/Gesto de utilizadores; b) A este subutilizador deve ser atribuda a operao WFA - Comunicao de dados de faturas; 3. Com base nos dados do documento comercial criado no passo n. 1 e nas credenciais solicitada no passo n. 2 deve construir o pedido SOAP tal como definido: a) No WSDL disponvel no endereo: http://info.portaldasfinancas.gov.pt/NR/rdonlyres/02357996-29FC-4F11-9F1D6EA2B9210D60/0/factemiws.wsdl b) Este pedido SOAP (Webservice) composto pelas seguinte seces descritas na seco 4 deste documento e que se resumem a: SOAP:Header - onde se incluem os campos de autenticao do utilizador que vai ser responsvel pela invocao do Webservice (a senha que vai

5 de Fevereiro de 2013

10 / 36

Manual de Integrao de Software Comunicao das Faturas AT

nesta seco tem que ser cifrada recorrendo chave pblica do sistema de autenticao do portal das finanas); SOAP:Body - contm os dados do documento comercial;

4. Estabelecer uma ligao segura em HTTPS com o portal das finanas e utilizando o seguinte endereo de envio de dados de faturas: https://servicos.portaldasfinancas.gov.pt:400/fews/faturas a) Para estabelecer esta ligao necessrio utilizar o certificado SSL previamente submetido e assinado pela AT, atravs do processo de adeso ao envio de dados das faturas por parte dos produtores de software; 5. Processar corretamente o cdigo de resposta devolvido pelo Webservice, que pode ser de dois tipos: a) mensagens de autenticao invlida; b) mensagens de processamento invlido dos dados de fatura; c) registo com sucesso dos dados de fatura. Para adaptar os programas de faturao recomendada execuo das seguintes fases implementao: Desenvolvimento Testes Distribuio Produo

3.1.1 Fase de Desenvolvimento


Para iniciar poder iniciar o desenvolvimento cada produtor de software deve obter junto da AT os elementos necessrios para o efeito, designadamente: 1. Criar subutilizador do prprio produtor de software fazendo-o no Portal das Finanas: Portal das Finanas -> Outros Servios -> Gesto de utilizadores

5 de Fevereiro de 2013

11 / 36

Manual de Integrao de Software Comunicao das Faturas AT

2. Obter a chave pblica do Sistema de Autenticao do Portal das Finanas para cifrar a senha do utilizador; 3. Obter certificado SSL para comunicao com o endereo de testes; 4. Obter o WSDL que define a estrutura do pedido SOAP a construir para enviar os dados das faturas, disponvel em: Site e-fatura -> pgina Produtores de Software -> opo Testar Webservice Ao criar o subutilizador no Portal das Finanas (1 passo) deve atribuir a autorizao WFA disponvel para a comunicao de dados das faturas. Para criar este utilizador necessrio indicar um Nome, uma senha (e respetiva confirmao) e um endereo de email para utilizao em contactos por parte da AT. No final obtm a identificao do subutilizador (e.g., 555555555/55) e a respetiva senha deve ser comunicada equipa de desenvolvimento. O envio de dados das faturas tem de respeitar o WSDL definido para o efeito e disponvel na pgina de produtores de software: Site e-fatura -> pgina Produtores de Software -> opo Testar Webservice Para obter a chave pblica do Sistema de Autenticao e o certificado SSL de comunicao em testes necessrio enviar um email AT a solicitar o envio dos mesmos. A mensagem a enviar por email devem respeitar o seguinte template: TO: Subject: asi-psws@at.gov.pt Obteno do certificado SSL para testes e chave pblica do sistema de Autenticao - NIF <NIF>

Exmos. Senhores, O Produtor de Software <NOME> (NIF <NIF>) vem por este meio solicitar o envio dos seguintes elementos para desenvolvimento e testes de envio de faturas por Webservice: Chave pblica do Sistema de Autenticao do PF; Certificado SSL para comunicao com o endereo de testes de Webservices.

Este elementos sero utilizado por este produtor de software para incluir nos

5 de Fevereiro de 2013

12 / 36

Manual de Integrao de Software Comunicao das Faturas AT

seguintes programas de faturao:


Designao Software <SOFTWARE 1> ... <SOFTWARE N> Certificado AT / DGCI <CERTIFICADO 1> ... <CERTIFICADO N>

Aguardamos a vossa resposta. No template anterior, cada produtor de software deve substituir os seguintes elementos pelos seus dados: <NIF> - Substituir pelo NIF do produtor de software;
<NOME> - Substituir pelo NIF do produtor de software. <SOFTWARE N> - Designao do software N <CERTIFICADO N> - N de certificado da AT (DGCI se ainda for o caso)

Para a correta construo do pedido SOAP (invocao do Webservice) deve utilizar a informao complementar disponvel neste documento na seco 4, onde se detalha a informao que deve constar dos campos do pedido SOAP bem como a sua forma de construo.

3.1.2 Fase de Testes


A AT disponibiliza um endereo de testes para verificao da comunicao de dados AT de forma a apoiar cada produtor de software na correta disponibilizao dos seus programas aos sujeitos passivos, seus clientes. Para este efeito, cada produtor de software deve seguir o seguinte procedimento: 1. Solicitar as credencias de subutilizador e senha criada para os testes de comunicao de faturas (e.g., 555555555/55 + SENHA); 2. Cifrar a senha e compor o SOAP:Header de acordo com o definido na seco 4.1; 3. Com base na fatura inserida, construir o SOAP:Body de acordo com o definido na seco 4.2;

5 de Fevereiro de 2013

13 / 36

Manual de Integrao de Software Comunicao das Faturas AT

4. Estabelecer uma ligao HTTPS com o seguinte endereo disponibilizado apenas para testes: a) https://servicos.portaldasfinancas.gov.pt:700/fews/faturas b) Este endereo s aceita ligaes com o certificado SSL disponibilizado para testes (vide 3.1.1); 5. Submeter o pedido SOAP construdo no ponto 3; 6. Processar a resposta que o servio lhe devolve de acordo com as varias hipteses definidas na seco 4.3. As respostas so dos seguintes tipos: a) Cdigo de sucesso; b) Erros de autenticao referentes aos campos do SOAP:Header; c) Erros nos dados da fatura referentes aos campos preenchidos no SOAP:Body. Para efeitos de despiste, disponibilizada um pgina de testes de conectividade e exemplos de pedido e resposta SOAP para comparao com o programa do produtor de software. Mais informao na seco 7 deste documento.

3.1.3 Fase de Distribuio


Depois de confirmarem a correta adaptao do programa de faturao e antes de distribuir os vossos programas aos vossos clientes (sujeitos passivos) necessrio proceder da seguinte forma: 1. Efetuar a adeso ao envio de dados de faturas atravs do formulrio disponvel em: Site e-fatura -> pgina Produtores de Software -> opo Aderir ao Servio a) necessrio aceitar os termos e condies do servio, disponveis para consulta no formulrio; b) Para completar o pedido de adeso necessrio gerar um certificado SSL de acordo com as instrues disponveis na seco 4.4; c) A AT responde a este pedido por mensagem de email contendo o certificado assinado com certificado digital da AT; 2. Alterar o endereo de comunicao para o endereo de comunicao de dados AT em ambiente de produo:
5 de Fevereiro de 2013 14 / 36

Manual de Integrao de Software Comunicao das Faturas AT

https://servicos.portaldasfinancas.gov.pt:400/fews/faturas 3. Substituir o certificado utilizado em testes (ponto 4 da Fase de Testes) pelo certificado de produo emitido no ponto 1 alnea c) desta fase. Depois de concluda este procedimento o(s) vosso(s) programas de faturao esto produtos para serem distribudos aos vossos clientes (sujeitos passivos).

3.1.4 Fase de produo


Depois de instalado o programa de faturao nos computadores dos vossos clientes (sujeitos passivos) est tudo pronto para comear o envio de faturas por Webservice. Cada sujeito passivo deve criar um subutilizador para a comunicao de dados das faturas de forma em tudo idntica ao definido no ponto 1 da Fase de Desenvolvimento (vide 3.1.1) e com permisses WFA, ou seja, para a comunicao de faturas AT. Depois de criado este subutilizador, o sujeito passivo, responsvel pelas credencias emitidas (utilizador e senha), deve configurar no programa de faturao estas credenciais, atravs de opo prpria. Por regra, o envio procede da seguinte forma: 1. Sujeito passivo emite fatura no programa de faturao; 2. So obtidas as credenciais do sujeito passivo configuradas no programa de faturao; 3. construdo o pedido SOAP e invocado o Webservice em produo com os dados do ponto 1 e ponto 2; 4. Programa processa a resposta do servio e informa o utilizador do sucesso ou solicita ao do utilizador para o caso de erro no envio. Uma vez que este servio deve ser utilizado no envio de cada fatura individualmente, sempre que o produtor de software identificar a necessidade de envio massivo de documentos comerciais, deve indicar ao sujeito passivo que tem de utilizar o envio por ficheiro SAF-T (PT), tal como definido na seco 3.2 deste documento.

5 de Fevereiro de 2013

15 / 36

Manual de Integrao de Software Comunicao das Faturas AT

3.2

Comunicao por SAF-T (PT)

Tal como descrito na seco 2.2 o envio do ficheiro SAF-T (PT) composto por dois passos: extrao a partir do software de faturao e posteriormente envio no site e-fatura. Para otimizao do envio, os produtores de software devem considerar implementar as seguintes caractersticas nos seus produtos: 1. Extrair a informao por ms ou por indicao de um determinado perodo (datas, por dia, etc.); 2. Extrair apenas a informao da tabela de clientes que tenham referencia em documentos comerciais desse ficheiro, no incluindo os restantes; Estas otimizao tm dois efeitos: reduzem o tamanho do ficheiro e consequentemente ocupam menos espao em disco; e consequentemente reduzem o tempo necessrio para processar cada ficheiro. Com reduo do tamanho poupa-se espao em disco e consumo de memria de cada processamento efetuado. Reduzindo a informao ao que relevante em cada ficheiro permite acelerar o tempo de extrao, validao local e consequentemente o tempo total de comunicao de faturas AT.

5 de Fevereiro de 2013

16 / 36

Manual de Integrao de Software Comunicao das Faturas AT

4 Estrutura do envio de dados AT (SOAP)


Nesta seco descreve-se informao complementar ao definido no WSDL do servio de comunicao de dados de documentos comerciais em tempo real. O servio disponibiliza uma operao de registo de Documento Comercial, que possibilita o envio dos elementos previstos no n. 4, do artigo 3. do Decreto-Lei n. 198/2012, fatura a fatura. O pedido efetuado segundo o protocolo SOAP e constitudo por duas seces: d) SOAP:Header; e) SOAP:Body A primeira seco, o Header, inclui todos os campos de autenticao do utilizador que vai ser responsvel pela invocao do Webservice. Este utilizador ser um subutilizador do NIF do sujeito passivo (comerciante emitente da fatura) com perfil WFA. Para criar o subutilizador deve ser utilizada a opo Servios tributrios/Outros servios/Gesto de utilizadores. A segunda seco contm os dados do documento comercial os quais se detalham no tpico SOAP:Body.

5 de Fevereiro de 2013

17 / 36

Manual de Integrao de Software Comunicao das Faturas AT

4.1

SOAP:Header

O desenho do Header tem como requisito garantir a confidencialidade dos dados de autenticao e a impossibilidade de reutilizao dos mesmos em ataques Man-in-the-middle (MITM). Por este motivo, s sero aceites invocaes que respeitem os seguintes procedimentos de encriptao. O SOAP:Header construdo de acordo com o standard WS-Security, definido pela OASIS e recorrendo definio do Username Token Profile 1.1, tambm definido pela mesma organizao. Na seguinte tabela, detalha-se a forma de construo de cada campo e de acordo com as necessidades de segurana especficas do sistema de autenticao do portal das finanas.
Parmetro H.1 - Utilizador (Username) Descrio Identificao do utilizador que vai submeter os dados, composto da seguinte forma e de acordo com a autenticao do portal das finanas: <NIF do emitente>/<UserId> Exemplos possveis: 1. 2. 3. H.2 - Nonce 555555555/1 (subutilizador n. 1) 555555555/0002 (subutilizador n. 2) 555555555/1234 (subutilizador n. 1234) S String (base64) Obrig.1 S Tipo 2 Dados String

Chave simtrica gerada a cada pedido e para cifrar o contedo dos campos H.3 - Password e H.4 - Created. Cada invocao do Webservice dever conter esta chave gerada aleatoriamente e a qual no pode ser repetida. Para garantir a confidencialidade, a chave simtrica tem de ser cifrada com a chave pblica do Sistema de Autenticao de acordo com o algoritmo RSA e codificada em Base 64. A chave pblica do sistema de autenticao do portal das finanas deve ser obtida por solicitao prpria e atravs do endereo de email asi-psws@at.gov.pt. O campo construdo de acordo com o seguinte

1 2

Obrigatrio:SSim;NNo. AvalidarnaespecificaoWSDL(WebServiceDefinitionLanguage)doservio
18 / 36

5 de Fevereiro de 2013

Manual de Integrao de Software Comunicao das Faturas AT

procedimento

Nonce : Base64(C RSA, KpubSA ( K s ))


KS := array de bytes com a chave simtrica de 128 bits, produzida de acordo com a norma AES. CRSA,KpubSA := Funo de cifra da chave simtrica com o algoritmo RSA utilizando a chave pblica do sistema de autenticao (KpubSA). Base64 := Codificao em Base 64 do resultado. H.3 - Password O campo Password dever conter a senha do utilizador / subutilizador, a mesma que utilizada para entrar no Portal das Finanas. Esta Password tem de ser cifrada atravs da chave simtrica do pedido (ver campo Nonce) e codificado em Base64.
AES , ECB , PKCS 5 Padding Password : Base64(C K ( SenhaPF )) s

string (base64)

SenhaPF := Senha do utilizador definido no campo H.1 - Username;


AES , ECB , PKCS 5 Padding CK s

:=

Funo

de

cifra

utilizando o algoritmo AES, Modelo ECB, PKCS5Padding e a chave simtrica do pedido (KS). Base64 := Codificao em Base 64 do resultado. H.4 - Data (Created) de sistema O campo Created dever conter a data e hora de sistema da aplicao que est a invocar o webservice. Esta data usada para validao temporal do pedido, pelo que crucial que o sistema da aplicao cliente tenha o seu relgio certo. Sugere-se a sincronizao Astronmico de Lisboa: com o Observatrio string (base64)

http://www.oal.ul.pt/index.php?link=acerto A zona temporal deste campo dever estar definida para UTC e formatado de acordo com a norma ISO 8601 tal como definido pelo W3C: http://www.w3.org/QA/Tips/iso-date

5 de Fevereiro de 2013

19 / 36

Manual de Integrao de Software Comunicao das Faturas AT

http://www.w3.org/TR/NOTE-datetime e.g.: 2013-01-01T19:20:30.45Z Este campo cifrado com a chave de pedido (KS) e codificada em Base 64.
AES , ECB , PKCS 5 Padding Created : Base64(C K (Timestamp )) s

Timestamp := data hora do sistema (UTC);


AES , ECB , PKCS 5 Padding CK s

:=

Funo

de

cifra

utilizando o algoritmo AES, Modelo ECB, PKCS5Padding e a chave simtrica do pedido (KS). Base64 := Codificao em Base 64 do resultado.

4.1.1 Exemplo SOAP:Header


Como resultado da aplicao das regras de construo anteriores ser produzido um header de pedido SOAP tal como o seguinte:
<S:Header> <wss:Security xmlns:wss="http://schemas.xmlsoap.org/ws/2002/12/secext"> <wss:UsernameToken> <wss:Username>599999993/37</wss:Username> <wss:Password>ikCyRV+SWfvZ5c6Q0bhrBQ==</wss:Password> <wss:Nonce> fkAHne7cqurxpImCfBC8EEc2vskyUyNofWi0ptIijYg4gYCxir++unzfPVPpusloEtmLkcZjf+E6 T9/76tsCqdupUkxOhWtkRH5IrNwmfEW1ZGFQgYTF21iyKBRzMdsJMhhHrofYYV/YhSPdT4dlgG0t k9Z736jFuw061mP2TNqHcR/mQR0yW/AEOC6RPumqO8OAfc9/b4KFBSfbpY9HRzbD8bKiTo20n0Pt amZevCSVHht4yt/Xwgd+KV70WFzyesGVMOgFRTWZyXyXBVaBrkJS8b6PojxADLcpWRnw5+YeOs3c PU2o1H/YgAam1QuEHioCT2YTdRt+9p6ARNElFg== </wss:Nonce> <wss:Created>>YEWoIoqIY5DOD11SeXz+0i4b/AJg1/RgNcOHOYpSxGk</wss:Created> </wss:UsernameToken> </wss:Security> </S:Header>

5 de Fevereiro de 2013

20 / 36

Manual de Integrao de Software Comunicao das Faturas AT

4.2

SOAP:Body

Nesta seco so definidos os campos para o registo de um novo documento comercial (Fatura, Fatura Simplificada, Nota de crdito e Nota de Dbito).
Parmetro Descrio Obrig.
3

Tipo 4 Dados int

1.1 NIF Emitente (TaxRegistrationNumber)

NIF do emitente Nmero de Identificao Fiscal portugus (sem qualquer prefixo do pas).

1.2 Nmero Documento (InvoiceNo)

Identificao nica do documento de venda Deve ser idntico ao que consta no ficheiro SAFT (PT), quando gerado a partir sistema de faturao que emitiu este documento; Deve respeitar o formato definido na legislao relativa ao ficheiro SAF-T (PT), em vigor aquando da comunicao dos elementos das faturas: o composto pelo cdigo interno do documento, seguido de um espao, seguido do identificador da srie do documento, seguido de uma barra (/), e de um nmero sequencial do documento dentro da srie;

string

No podem existir registos com a mesma identificao; S date

1.3 Data Emisso (InvoiceDate) 1.4 Tipo (InvoiceType)

Data de emisso do documento

Tipo de documento. Pode assumir os seguintes valores: FT Fatura; FS Fatura Simplificada;

string

3 4

Obrigatrio:SSim;NNo. AvalidarnaespecificaoWSDL(WebServiceDefinitionLanguage)doservio
21 / 36

5 de Fevereiro de 2013

Manual de Integrao de Software Comunicao das Faturas AT

1.4 Estado (InvoiceStatus)

NC .Nota de Crdito; ND Nota de Dbito; S string

Estado de documento. Pode assumir os seguintes valores: N Normal; A Anulada;

1.5 NIF Adquirente (CustomerTaxID)

NIF do adquirente nacional Nmero de Identificao Fiscal portugus (sem qualquer prefixo do pas); Deve ser preenchido sempre que se trate de um adquirente nacional; Quando no tenha sido recolhido no sistema de faturao do emissor, deve ser preenchido com 999999990 Este campo mutuamente exclusivo com o campo 1.6 NIF Adquirente Estrangeiro (InternationalCustomerTaxID). Deve ser obrigatoriamente preenchido um, e apenas um dos campos.

int

1.6 NIF Adquirente Estrangeiro (InternationalCustomerTaxID) Este campo mutuamente exclusivo com o campo 1.5 NIF Adquirente (CustomerTaxID). Deve ser obrigatoriamente preenchido um, e apenas um dos campos. Deve ser preenchido sempre que se trate de um adquirente estrangeiro, cujo NIF tenha sido recolhido no sistema de faturao do emissor;

string

1.6.1 NIF Adquirente Estrangeiro (TaxIDNumber)

NIF do adquirente estrangeiro Nmero de Identificao Fiscal estrangeiro (sem prefixo do pas).

string

1.6.2 Pas do NIF

Pas do NIF do adquirente estrangeiro

string

5 de Fevereiro de 2013

22 / 36

Manual de Integrao de Software Comunicao das Faturas AT

Adquirente Estrangeiro (TaxIDCountry)

Cdigo de dois caracteres (alfa2) segundo a norma ISO 3166. S

1.7 Linhas do Documento por Taxa (Line) Resumo das linhas da fatura por taxa de imposto, e motivo de iseno. Deve existir uma, e uma s linha, por cada taxa (TaxType, TaxCountryRegion, TaxCode) e motivo de iseno (TaxExemptionReason) Somatrio do valor das linhas, sem imposto, deduzido dos descontos de linha e cabealho, onde foi aplicada a taxa e/ou motivo de iseno descritos em 1.7.3 Taxa (Tax). Obrigatrio para as Notas de Crdito. Nos restantes tipos de documento, deve ser preenchido apenas o campo 1.7.2 Valor a Crdito (CreditAmount). 1.7.2 Valor a Crdito (CreditAmount) Somatrio do valor das linhas, sem imposto, deduzido dos descontos de linha e cabealho, onde foi aplicada a taxa e/ou motivo de iseno descritos em 1.7.3 Taxa (Tax). Obrigatrio para as Faturas, Faturas Simplificadas e Notas de Dbito. Nas Notas de Crdito, deve ser preenchido apenas o campo 1.7.1 Valor a Dbito (DebitAmount). 1.7.3 Taxa de Imposto (Tax) 1.7.3.1 Regime de Imposto (TaxType) Tipo de taxa. Deve assumir valor: 1.7.3.2 Regio do Imposto (TaxCountryRegion) IVA imposto sobre o valor acrescentado.

1.7.1 Valor a Dbito (DebitAmount)

decimal

decimal

S S string

Deve ser preenchido com: PT espao fiscal de Portugal continental; PT-AC espao fiscal da Regio Autnoma dos Aores; PT-MA espao fiscal da Regio Autnoma da Madeira.

string

1.7.3.3 Percentagem da Taxa de Imposto (TaxPercentage)

Taxa de IVA aplicada Dever ser preenchido com a percentagem da

decimal

5 de Fevereiro de 2013

23 / 36

Manual de Integrao de Software Comunicao das Faturas AT

taxa correspondente ao imposto aplicvel ao campo 1.7.1 Valor a Dbito (DebitAmount) ou ao campo 1.7.2 Valor a Crdito (CreditAmount). Dever ser preenchido com 0 (zero) caso se trate uma aquisio ou prestao isenta de IVA. N string

1.7.3.4 Motivo de Iseno (TaxExemptionReason)

Motivo de iseno de IVA Campo de preenchimento obrigatrio quando se trate de uma aquisio ou prestao de servio isenta de IVA. Deve ser preenchido com os cdigos da tabela Motivos de Iseno de IVA, que consta do Anexo 3.1 deste documento.

1.8 Totais do Documento (DocumentTotals) 1.8.1 Valor do Imposto (TaxPayable) Valor do imposto a pagar. Deve incluir apenas os impostos contemplados nas linhas de resumo por taxa em 1.7 Linhas do Documento por Taxa (Line).

S S decimal

1.8.2 Valor Tributvel (NetTotal) 1.8.3 Montante Total (GrossTotal)

Total do documento sem imposto.

decimal

Total do documento com imposto. Deve incluir o valor tributvel e todos os impostos aplicveis ao documento, mesmo que no contemplados nas linhas de resumo por taxa em 1.7 Linhas do Documento por Taxa (Line).

decimal

5 de Fevereiro de 2013

24 / 36

Manual de Integrao de Software Comunicao das Faturas AT

4.2.1 Motivos de Iseno de IVA


Motivo de iseno a indicar no campo 1.7.3.4 Motivo de Iseno (TaxExemptionReason):
Cdigo (1.7.3.4) M01 M02 M03 Meno a constar na fatura Artigo 16. n. 6 alnea c) do CIVA Artigo 6. do Decreto-Lei n. 198/90, de 19 de Junho Exigibilidade de caixa Norma aplicvel Artigo 16. n. 6 alnea c) do CIVA Artigo 6. do Decreto-Lei n. 198/90, de 19 de junho Decreto-Lei n. 204/97, de 9 de agosto Decreto-Lei n. 418/99, de 21 de outubro Lei n. 15/2009, de 1 de abril M04 M05 M06 M07 M08 Isento Artigo 13. do CIVA Isento Artigo 14. do CIVA Isento Artigo 15. do CIVA Isento Artigo 9. do CIVA IVA autoliquidao Artigo 13. do CIVA Artigo 14. do CIVA Artigo 15. do CIVA Artigo 9. do CIVA Artigo 2. n. 1 alnea i) do CIVA Artigo 2. n. 1 alnea j) do CIVA Artigo 6. do CIVA Artigo 2. n. 1 alnea l) do CIVA Decreto-Lei n. 21/2007, de 29 de janeiro Decreto-Lei n. 362/99, de 16 de setembro M09 M10 M11 M12 M13 M14 M15 M16 IVA - no confere direito a deduo IVA Regime de iseno No tributado Regime da margem de lucro Agncias de viagens Regime da margem de lucro Bens em segunda mo Regime da margem de lucro Objetos de arte Regime da margem de lucro Objetos de coleo e antiguidades Isento Artigo 14. do RITI Artigo 60. CIVA Artigo 72. n. 4 do CIVA Artigo 53.do CIVA Decreto-Lei n. 346/85, de 23 de agosto Decreto-Lei n. 221/85, de 3 de julho Decreto-Lei n. 199/96, de 18 de outubro Decreto-Lei n. 199/96, de 18 de outubro Decreto-Lei n. 199/96, de 18 de outubro Artigo 14. do RITI

4.2.2 Exemplo SOAP:Body


<S:Body> <ns2:RegisterInvoiceElem xmlns:ns2="http://servicos.portaldasfinancas.gov.pt/faturas/"> <TaxRegistrationNumber>222222222</TaxRegistrationNumber> <ns2:InvoiceNo>FT 1/1</ns2:InvoiceNo> <ns2:InvoiceDate>2012-05-05</ns2:InvoiceDate> <ns2:InvoiceType>FT</ns2:InvoiceType> <ns2:InvoiceStatus>N</ns2:InvoiceStatus> <CustomerTaxID>111111111</CustomerTaxID> <Line> <ns2:DebitAmount>100</ns2:DebitAmount> <ns2:Tax><ns2:TaxType>IVA</ns2:TaxType> <ns2:TaxCountryRegion>PT</ns2:TaxCountryRegion> <ns2:TaxPercentage>23</ns2:TaxPercentage> </ns2:Tax> </Line>

5 de Fevereiro de 2013

25 / 36

Manual de Integrao de Software Comunicao das Faturas AT

<DocumentTotals> <ns2:TaxPayable>23</ns2:TaxPayable> <ns2:NetTotal>100</ns2:NetTotal> <ns2:GrossTotal>123</ns2:GrossTotal> </DocumentTotals> </ns2:RegisterInvoiceElem> </S:Body>

5 de Fevereiro de 2013

26 / 36

Manual de Integrao de Software Comunicao das Faturas AT

4.3

Resposta ao pedido SOAP


Descrio Obrig.
5

Parmetro

Tipo 6 Dados Int

Cdigo do resultado (ReturnCode)

Cdigo do resultado da invocao desta interface. Se a resposta for zero, a operao foi bem sucedida. Se for um nmero diferente de zero, significa que a operao no foi bem sucedida. Cdigo de sucesso: 0 Documento registado com sucesso. Cdigos de resposta (autenticao): 1 - Utilizador no preenchido; 2 - Tamanho do utilizador incorreto; 3 - NIF invlido; 4 - Utilizador com formato invlido; 5 - Subutilizador com formato invlido; 6 - Senha no preenchida; 7 - Codificao Base64 invlida; 8 - Cifra da chave pblica invlida; 9 - Formato do Timestamp invlido; 10 - Validade da credencial expirada; 11 - Chave simtrica invlida; 12 - Chave simtrica repetida; 13 - Estrutura da senha invlida; 99 - Erro na validao da senha (Senha errada, acesso suspenso, etc.). Cdigos de resposta (dados das faturas): -1 Parmetros de entrada invlidos;

5 6

Obrigatrio:SSim;NNo. AvalidarnaespecificaoWSDL(WebServiceDefinitionLanguage)doservio
27 / 36

5 de Fevereiro de 2013

Manual de Integrao de Software Comunicao das Faturas AT

-2 Data de emisso invlida; -3 Documento duplicado; -4 Entidade emissora no tem permisses para registar documentos com o NIF de emitente indicado; -98 A integridade referencial, multiplicidade ou tipo de dados dos parmetros de entrada so invlidos; -99 Erro interno; Mensagem (ReturnMessage) Mensagem descritiva da resposta. 1 String

4.4

Exemplo completo de pedido SOAP

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Header> <wss:Security xmlns:wss="http://schemas.xmlsoap.org/ws/2002/12/secext"> <wss:UsernameToken> <wss:Username>599999993/37</wss:Username> <wss:Password>ikCyRV+SWfvZ5c6Q0bhrBQ==</wss:Password> <wss:Nonce> fkAHne7cqurxpImCfBC8EEc2vskyUyNofWi0ptIijYg4gYCxir++unzfPVPpusloEtmLkcZjf+E6 T9/76tsCqdupUkxOhWtkRH5IrNwmfEW1ZGFQgYTF21iyKBRzMdsJMhhHrofYYV/YhSPdT4dlgG0t k9Z736jFuw061mP2TNqHcR/mQR0yW/AEOC6RPumqO8OAfc9/b4KFBSfbpY9HRzbD8bKiTo20n0Pt amZevCSVHht4yt/Xwgd+KV70WFzyesGVMOgFRTWZyXyXBVaBrkJS8b6PojxADLcpWRnw5+YeOs3c PU2o1H/YgAam1QuEHioCT2YTdRt+9p6ARNElFg== </wss:Nonce> <wss:Created>>YEWoIoqIY5DOD11SeXz+0i4b/AJg1/RgNcOHOYpSxGk</wss:Created> </wss:UsernameToken> </wss:Security> </S:Header> <S:Body> <ns2:RegisterInvoiceElem xmlns:ns2="http://servicos.portaldasfinancas.gov.pt/faturas/"> <TaxRegistrationNumber>222222222</TaxRegistrationNumber> <ns2:InvoiceNo>FT 1/1</ns2:InvoiceNo> <ns2:InvoiceDate>2012-05-05</ns2:InvoiceDate> <ns2:InvoiceType>FT</ns2:InvoiceType> <ns2:InvoiceStatus>N</ns2:InvoiceStatus> <CustomerTaxID>111111111</CustomerTaxID> <Line> <ns2:DebitAmount>100</ns2:DebitAmount> <ns2:Tax><ns2:TaxType>IVA</ns2:TaxType> <ns2:TaxCountryRegion>PT</ns2:TaxCountryRegion> <ns2:TaxPercentage>23</ns2:TaxPercentage> </ns2:Tax> </Line> <DocumentTotals> <ns2:TaxPayable>23</ns2:TaxPayable> <ns2:NetTotal>100</ns2:NetTotal> <ns2:GrossTotal>123</ns2:GrossTotal> </DocumentTotals> </ns2:RegisterInvoiceElem> </S:Body> </S:Envelope>

5 de Fevereiro de 2013

28 / 36

Manual de Integrao de Software Comunicao das Faturas AT

5 de Fevereiro de 2013

29 / 36

Manual de Integrao de Software Comunicao das Faturas AT

5 Assinatura certificado SSL (CSR)


A invocao dos servios web pressupe um processo de autenticao mediante a validao da chave privada da aplicao, do conhecimento exclusivo do produtor de software (entidade aderente), sendo a respetiva chave pblica comunicada e assinada pela AT. O certificado a ser utilizado na operao assinado pela AT, a pedido da entidade aderente. Para este efeito, a empresa aderente deve efetuar um pedido de certificado (CSR Certificate Signing Request). O CSR um pequeno ficheiro de texto cifrado que contm o certificado SSL e toda a informao necessria para que a AT possa assinar e devolver o certificado assinado digitalmente para que possa ser utilizado no processo de autenticao na invocao do servio web de apoio submisso de faturas. Os procedimentos para gerao do CSR so simples mas variam de acordo com a tecnologia web utilizada pela entidade aderente, razo pela qual devem ser consultados os respetivos manuais de apoio de cada ferramenta. A informao que o CSR deve conter a seguinte, no podendo ultrapassar os tamanhos mximos indicados pois vai ultrapassar o tamanho total aceite para o campo CSR e onde todos os campos tm de estar preenchidos com informao relevante ou de acordo com a descrio abaixo:
Campo CSR Descrio O cdigo ISO de 2 letras referente ao local da sede. Por exemplo, no caso de Portugal PT. ST = Province, Region, County or State L = Town/City 32 (chars) Tamanho Mximo 2 (chars)

C = Country

Distrito da sede.

Local da sede. Neste campo deve ser indicado o nmero de identificao fiscal da entidade aderente.

32 (chars) 9 (chars)

CN = Common Name

O = Business Name / Organisation

Designao legal da empresa.

180 (chars)

5 de Fevereiro de 2013

30 / 36

Manual de Integrao de Software Comunicao das Faturas AT

OU = Department Name /Organisational Unit

Departamento para contacto.

180 (chars)

E = An email address

O endereo de correio eletrnico para contacto, geralmente do responsvel pela emisso do CSR ou do departamento de informtica. Tem que ser um endereo de email vlido. Chave pblica do certificado SSL gerado pelo produtor de software tem de ser gerado com 2048 bits.

80 (chars)

2048 (bits)

Key bit length

A utilizao de carateres especiais (e.g., portugueses, lnguas latinas, etc.) no aceite em nenhum dos campos acima indicados, uma vez que a utilizao desses carateres vai invalidar a assinatura digital do certificado SSL. Como resultado deste processo a AT proceder assinatura do certificado e remete em resposta ao pedido o certificado assinado para integrao na chave privada do produtor de software. O certificado ter a validade de 12 meses a contar da data da assinatura.

5.1

Gerar um certificado SSL

Um certificado SSL uma chave RSA composta por duas partes: chave privada e chave pblica. Como a chave privada deve ser apenas do conhecimento do produtor de software a emisso da mesma tem sempre de ser efetuada pelo prprio, em computador prprio e nunca num site ou servio web que encontre para o efeito. Existem diversas ferramentas para gerao de certificados SSL, proprietrias e Opensource. Para efeitos de exemplo a AT utiliza a ferramenta OpenSSL, que a ferramenta Opensource de referncia, livre de custos de utilizao. Para gerar um certificado SSL cada produtor de software deve faz-lo no seu prprio computador utilizando o seguinte comando: openssl req -new -subj "/C=PT/ST=Distrito da Sede/L=Local da Sede/O=Empresa /OU=Departamento de Informatica/CN=555555555/emailAddress=informatica@empresa.pt" -newkey rsa:2048 -nodes -out 555555555.csr -keyout 555555555.key

5 de Fevereiro de 2013

31 / 36

Manual de Integrao de Software Comunicao das Faturas AT

Cada produtor de software deve substituir a informao especifica no comando anterior pelos seus dados, uma vez que os apresentados so apenas exemplificativos e no deve alterar a informao indicada a BOLD. Como resultado o comando anterior ser gerado o certificado SSL e sero produzidos dois ficheiros: 555555555.csr - Ficheiro com o pedido CSR a enviar AT; 555555555.key - Ficheiro com a chave privada gerada.

5.2

Integrar certificado com a chave privada

Depois de receber o certificado SSL assinado pela chave digital da AT necessrio integrar esse certificado com a chave privada gerada no passo anterior (555555555.key). Para tal deve ser usado o seguinte comando: openssl pkcs12 -export -in 555555555.crt -inkey 555555555.key -out 555555555.pfx Onde cada produtor de software deve substituir os parmetros que no esto a BOLD pelos nomes dos ficheiros corretos. Como resultado, o certificado SSL assinado pela AT integrado com a chave privada e gravada com uma password de acesso que cada produtor de software deve definir na execuo do comando.

5 de Fevereiro de 2013

32 / 36

Manual de Integrao de Software Comunicao das Faturas AT

6 Endereos teis
6.1 Pgina de produtores de software

https://www.portaldasfinancas.gov.pt/pt/external/factemipf/painelInicialProdSoftware.action

6.2

Certificao de software de faturao

http://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/CertificacaoSoftware.htm

6.3

SAF-T (PT) - Verso portuguesa

http://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/NEWS_SAF-T_PT.htm

6.4

Gesto de subutilizadores no PF

https://www.portaldasfinancas.gov.pt/pt/external/factemipf/painelInicialProdSoftware.action

6.5

WSDL do envio de dados AT por Webservice

http://info.portaldasfinancas.gov.pt/NR/rdonlyres/02357996-29FC-4F11-9F1D6EA2B9210D60/0/factemiws.wsdl

6.6

Endereos para envio de dados AT por Webservice

Ambiente de testes https://servicos.portaldasfinancas.gov.pt:700/fews/faturas Ambiente de produo https://servicos.portaldasfinancas.gov.pt:400/fews/faturas

5 de Fevereiro de 2013

33 / 36

Manual de Integrao de Software Comunicao das Faturas AT

7 Teste de conectividade do Webservice em testes


Na pgina de apoio aos produtores de software tambm se encontra uma Applet em Java para testar a conectividade ao endereo de testes. https://www.portaldasfinancas.gov.pt/pt/external/factemipf/testarLigacaoWebService.action Esta applet constri um envio de dados AT para o ambiente de testes, com base nas credencias inseridas na prpria Applet e alguns dados de faturas. A Applet tem um campo de texto onde pode ser obtido o pedido SOAP e a resposta do Webservice em ambiente de testes.

Tambm nesta pgina de teste de conectividade est o cdigo fonte da Applet em Java para consulta dos produtores de software como forma de apoio ao desenvolvimento das adaptaes que tm de efetuar aos seus programas de faturao para estes enviarem os dados por Webservice.

5 de Fevereiro de 2013

34 / 36

Manual de Integrao de Software Comunicao das Faturas AT

8 Glossrio
Tabela de acrnimos, abreviaturas e definies de conceitos utilizados neste documento, ordenados alfabeticamente por termo.

Termo
AES Chave Pblica do SA ECB

Definio
http://csrc.nist.gov/publications/fips/fips197/fips197.pdf http://wsautentica.segautenticacaodev.ritta.local/certificates/SA.cer RefernciadoECB: http://www.itl.nist.gov/fipspubs/fip81.htm ExplicaodoECB: http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Electron ic_codebook_.28ECB.29 ObservatrioAstronmicodeLisboa:http://www.oal.ul.pt/ ParaacertarahoradocomputadorseguindoasinstruesdoObservatrio: http://www.oal.ul.pt/index.php?link=acerto
http://www.openssl.org/ Portal das Finanas: www.portaldasfinancas.gov.pt Referncia do PKCS #5: http://tools.ietf.org/html/rfc2898 Explicao do PKCS #5: http://en.wikipedia.org/wiki/PKCS Sistema de autenticao do Portal das Finanas: www.acesso.gov.pt. Sistema responsvel por validar as credenciais de um utilizador registado no Portal das Finanas. http://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/NEWS_SAF-T_PT.htm http://www.w3.org/TR/soap/

OAL

OpenSSL PF PKCS#5

SA

SAF-T (PT) SOAP Standard Date Format ISO 8601

http://www.w3.org/TR/NOTEdatetime http://www.w3.org/QA/Tips/isodate
https://www.oasis-open.org/committees/download.php/16782/wss-v1.1-spec-osUsernameTokenProfile.pdf

Username Token Profile

5 de Fevereiro de 2013

35 / 36

Manual de Integrao de Software Comunicao das Faturas AT

Webservice WS-Security

http://www.w3.org/TR/ws-arch/ https://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-osSOAPMessageSecurity.pdf http://www.w3.org/TR/wsdl

WSDL

5 de Fevereiro de 2013

36 / 36