DOCUMENTAÇÃO API

API

O portal SAFT.PT disponibiliza uma Web API REST que lhe permite aceder aos dados de uma subscrição. Esta API cobre o acesso a clientes, fornecedores, documentos de venda e compras seja a fonte de dados o ficheiro SAF-T PT ou o portal do E-FATURA, permitindo a consulta de dados. Deste modo é possível criar soluções que integrem o SAFT.PT com qualquer outro sistema.

VISÃO GLOBAL

A API da Web SAFT é uma API da Web RESTful que permite acessar os dados de uma assinatura do cliente. Essa API fornece acesso aos dados do cliente dentro do escopo da autorização fornecida pelo usuário. A autorização é gerenciada pela estrutura do OAuth 2.0. Os pontos de extremidade da API da Web fornecem acesso aos recursos do aplicativo e todos seguem a mesma estrutura e fornecem um conjunto semelhante de operações.

A estrutura da URL de cada terminal é a seguinte:

https://saft.pt/api.php?tokenid={tokenid}&op={op}&startdate={startdate}&enddate={enddate}&docn={docn}&src={src}

{tokenid} identificam o token gerado na página definições do utilizador.
{op} identificam o tipo de operação que está a tentar aceder. O conjunto padrão é o seguinte:
Clientes: op= cli
Fornecedores: op= for
Artigos: op= art
Documentos de vendas: op= sd
Documentos de compras: op= pd
Listagem do cabeçalho de documentos de vendas: op= lsd
Listagem do cabeçalho de documenos de compras: op= lpd
{src} identifica a fonte de dados (SAFT ou E-FATURA).
{docn} identifica o numero do documento relacionado a pesquisa de dados que esta a tentar efetuar
{startdate}{enddate} identificam o periodo relacionado a pesquisa de dados que está a tentar efetuar.

Os documentos retornados pelos operadores dv e dc incluem cabeçalho e linhas do documento.

Todas as consultas estão limitadas ao máximo de 2000 registos.

Os dados das consultas realizadas são retornados em formato JSON.

{resource} identificam o recurso de negócios que você está tentando acessar (os recursos são organizados pelo modelo de negócios do aplicativo ao qual eles pertencem). Para cada recurso, um conjunto de operações está disponível.

O conjunto padrão é o seguinte:
GET - Permite obter um registo existente.
CREATE - {brevemente disponível}
UPDATE - {brevemente disponível}
DELETE - {brevemente disponível}


Exemplo:

Obter documento de venda num intervalo de datas de informação do E-FATURA

Dados:
tokenid = fa69130f140bbdd368498e1bc3aecb67
op = sl
startdate = 2019-01-10
enddate = 2019-01-20
src = efatura

URL:
GET /api.php?tokenid=fa69130f140bbdd368498e1bc3aecb67&op=sl&startdate=2019-01-10&enddate=2019-01-20&src=efatura

Resposta ao pedido em formato JSON:

{"sd":[
{"InvoiceNo":"FA 2019/01","InvoiceType":"FT","InvoiceDate":"2019-01-10","InvoiceStatus":"N","SourceID":"","Hash":"","HashControl":"bi0k","Period":"6","SystemEntryDate":"0000-00-00 00:00:00","TransactionID":null,"CustomerID":"","NetTotal":"3550.00","TaxPayable":"0.00","GrossTotal":"3550.00","line":[{"Tax":"0.00","TaxPayable":"0.00","NetTotal":"3550.00","GrossTotal":"3550.00"}]}
]}


ficheiro saft contabilidade faturacao software de facturação facturas manuais verificar faturas finanças e fatura registar faturas software de restauração facturacao software facturação certificado software primavera preços e fatura saft finanças saft e fatura facturação online registo facturas envio ficheiro saft fora de prazo nova tabela irs saft faturas simplificadas fatura factura pt software restauração facturação online finanças e fatura programa de facturação facturas finanças facturas manuais entrega saft software de gestão registadoras certificadas fatura finanças e fatura ficheiro saft contabilidade finanças irs faturas online emissão de facturas finanças facturas faturas manuais software de gestão online programa de gestão de stocks faturação software facturacao programa de facturação registar faturas saft finanças efatura portal finanças recibos programa de faturaçao software facturação certificado livro de facturas software de gestão primavera entrega saft envio de saft faturacao online e factura registo facturas software gestão facturação finanças facturas e factura software certificado envio de saft envio ficheiro saft fora de prazo facturação software de facturação software de contabilidade validador saft 1.04 offline validador saft 1.04 financas validador saft occ validador saft contabilidade occ saft contabilidade 2019 saft faturação 2019 saft prazo 2019 comunicação saft 2019 data limite envio saft 2019 alterações saft 2019 prazo entrega saft contabilidade 2019 validador saft 1.03 validador saft 1.04 portal das finanças erro de validação saft validador saft 1.04 portal das finanças validador saft 1.04 financas analisador saft gratuito validador saft 1.04 finanças validador saft 1.04 autoridade tributária analisador saft 2018 analisador saft 2019 validador saft 1.04 online validador saft 1.04 at validador saft contabilidade at saft online saft excel criar ficheiro saft a partir do excel e-fatura excel importar dados e-fatura importar compras e-fatura e fatura exportar excel facturas online faturação online e fatura consumidor encontrar fatura validar saft occ validador saft 1.04 offline validar saft contabilidade occ validador saft 1.04 portal das finanças validador saft 1.04 financas validador saft taxonomias validador saft contabilidade at validador saft 1.04 at portal das finanças anda a conta gotas saf t da contabilidade software validação saft saft pt saft 1.04 validador validador saf t safrt on line importador saft faturas envio de saft 2019 valida saft e fatura ficheiro saft excel recibos electrónicos emitir saf t pt portal das finanças l saiba como consultar o reembolso do seu irs finanças saft at autoridade tributária e aduaneira consulta factura de abril edp comercial constança ribeiro araujo saft validador saft 2019 erros validador do saft portal das finanças com problemas de acesso manual saft saft da contabilidade analisador saft 2019 enviar saft autoridade tributaria visualizador saft portatil ficheirom saft ordens de pagamento saft https www occ pt pt noticias saf t pt da contabilidade conversor e minuta leitura saft sam4s sps 530 como tirar saf t saft numero documento saf t analisador saft 1.04 online verificar saft portal das finanças validador saft contabilidade occ leitor saft www portaldasfinasas gov pt saft contabilidade fsaft preencher irs 2019 substituir saft e faturas browser para enviar saft ficheiro saft autoridade tributária portugal software para integração saft declaração de irs validar saft enviar saft mac analisador de saft validar saft contabilidade enviar ficheiro saft saft online schema saft 1.04 facturas validador saft 1.04 finanças saft on line testar ficheiro saft vendas finanças portal portal das finanças facturação validador saft contabilidade 2019 ficheiro validação saf t saf t contabilidade validação saft contabilidade portaldasfinancas gov pt imi portal das finanças acesso como validar conteúdo de ficheiros saft free como comunicar auto facturação ás finanças como lançar saf t contribuinte autoridade tributária e aduaneira correção ficheiro saft sagft entregar ficheiro saft validador saft arredondamentos ficheiro saft como alterar saf t t&t enviar saft conversor saft para excel validador saft contabilidade saft vereficação de valores iva na administração pública como validar uma faturação eletrónica validadar saft cbl como abrir ficheiro saft portal das finanças facturação validar saft contabilidade occ saft contabilidade validador de saft saft t analisador saft contabilidade saft validador validador saft 1.04 online portal das finanças e facturas programa saft gratuito recibos electrónicos de renda e e fatura finanças pt portal das finanças facturação conta 2432 devera estar a zeros no ficheiro saft t e fatura passo a passo efatura portal das finanças www portaldasfinanças gov pt portal das finanças obter novidades em relação ao saft da contabilidade saf t pt validador saft 1.04 saft contabilidade assembleia republica fatura endesa saft contabilidade editar ficheiro saft como confirmar faturas no portal das finanças validador saft at corrigir saft arredondamentos saft login portal das finanças como jmuntar um head company a um saft saf t da contabilidade validador saft occ saft manual saft contabilidade saft vendas validar saft pt versão 1.04 ficheiros saft portal da at saft contabilidade 2019 saft contabilidade 2019 e fatura e fatura ficcheiro saft ficheiro saft contabilidade www portaldasfinancas gov pt validador saft contabilidade 2019 enviar saft declaraçoes eletronicas submeter saft pt ler ficheiros saft validador saft contabilidade saft contabilidade 2019 como preencher o irs 2019 passo a passo e fatura validar saft 1.04 http info portaldasfinancas gov pt apps saft pt01 local validador exe exportar saft para excel validar ficheiro saft contabilidade validar saf t cuidados a ter com o saft da contabilidade analisador saft faturação portal das financas saftonline preços validador saft contabilidade occ e fatura passo a passo development code to obtain purchase saft enviar ficheiro saft analisador saft contabilidade ficheiros saft formação saf t portal das financas irs www portaldasfinancas gov pt www portaldasfinancas gov pt saf t portal senhas at gov pt como validar um ficheiro saft occ validador saft como atualizar o agregado familiar no portal das finanças preenchimento de série para saf t validador do saft conversor occ saf t pt 1.04 excel abrir ficheiro saft online ministerio das financas como emitir recibos verdes saft 1.02 centralgest validador saft saft 2019 portal das finanças irs validação saft portal das financas entrar portal das finanças descida do iva na eletricidade só deverá chegar à fatura em abril portaldasfinanças gov pt validador saft taxonomias analisador saft pt contribuintes impossibilitados de consultar o portal das finanças saft pt validar hash saft ficheiro saft 2019 www e financas gov pt leitor de saft estrutura saft 1.04 converter excel em saft portal financas financas irs e faturas envio de saf t validador saft contabilidade occ validar saft contabilidade ficheiro saf t conversor saft ficheiro saft contabilidade portal das finanças facturação efatura saft da contabilidade occ analisador saft portal finanças envio saft validar sft validador saft 1.04 portal das finanças portal de financas ficheiro saft saft da contabilidade nova versão saft conta 32 saldos não podem ser a zero no saft pt simulador saft contabilidade occ e fatura saft espanha portal das finanças portal das financas portal das finanças registo analisador saft occ portal das finanças facturação ficheiro saft testar saft consultar facturas analisador saft contabilidade corrigir ficheiro saft saft para advogado validador saft finanças saft validar dgci gov pt portagens ctt pt fatura saf t contabilidade saft contabilidade finanças e saft saft pt enviar saf t validador saft 1.04 offline visualizador saft gratuito portal das financas ficheiro saft anual www gov pt validador saft contabilidade 2019 centralgest saft centralgest saft o novo portal das finanças já está disponível tudo que pode fazer no portal das finanças irs saf t exemplo falta de faturas adia reembolsos na tap abrir saft em excel analisador saft saft pt at autoridade tributaria e aduaneira entregar saft como preencher recibos verdes electrónicos saft finanças alterar valores xml saft portal das financas declaracao irs portal das financas declaracao irs saft onde inserir validador saft occ programa saft www portaldasfinanças gov pt portal de finanças saft 2019 saft 2019 testar saft contabilidade financas saft online conversor de linux para windows saft financas pt como pedir a senha de acesso ao portal das finanças