API de recibosRecibos conformes comuma integração
A API PosDealer permite aos utilizadores gerir direitos, acompanhar instalações e fornecer configurações compatíveis em milhares de instalações.
A API de recibos do fiskaltrust
A API de recibos da fiskaltrust é a interface central para gerir o ciclo de vida dos recibos. Abrange a criação, assinatura, emissão, transporte, recuperação e acesso de auditoria dos recibos de uma forma consistente e regulamentada. Os recibos são tratados como um componente central do sistema, independentemente do canal, dispositivo ou método de entrega, e funcionam da mesma forma em todos os mercados suportados.
A API permite-te concentrar no teu sistema enquanto a fiskaltrust trata da infraestrutura de receção. Em vez de criar e manter formatos específicos de cada país, lógica de transporte e casos extremos, confia numa API unificada e de código aberto que se mantém estável enquanto os regulamentos e os requisitos operacionais mudam.
Funcionalidades principais da API
Funcionalidades principais da API
- criar – Recibo com itens, pagamentos e totais.
- sign – Aplica regras fiscais nacionais, assinaturas e encadeamento de hash.
- emissão – Entrega o recibo em HTML, PDF, código QR ou por e-mail/SMS.
- obter – Obtém recibos por ID, referência de encomenda ou intervalo de tempo.
- verify – Valida as assinaturas e a integridade.
- Revogar – Marca um recibo como cancelado ou corrigido.
- diário – Exporta registos de auditoria, encerramentos e relatórios.
Caraterísticas principais
- Flexibilidade de formato: Podes obter recibos como visualizações ou dados em bruto. Escolhe entre formatos como HTML, PDF, PNG ou JSON.
- Conformidade: A API garante que os teus recibos cumprem os requisitos legais.
- Rapidez: Utiliza o POS-API Helper para carregar os recibos instantaneamente. Sem este auxiliar, os carregamentos podem demorar até cinco minutos.
- Obtenção de dados: A API fornece uma forma segura de aceder aos dados dos recibos. Isto permite-te integrar os recibos nas tuas próprias aplicações.
Cada operação corresponde às etapas do ciclo de vida do recibo. Um recibo é criado a partir dos dados da encomenda e do pagamento, assinado ao abrigo da legislação nacional e emitido para o consumidor. Pode ser recuperado para devoluções, verificado para auditorias, revogado se for corrigido e exportado como parte de um diário. Todo o processo é determinístico, inviolável e alinhado com as regras de cada país.
A API de recibos fornece uma base resiliente para o tratamento de recibos, facilitando a integração, reduzindo a complexidade e assegurando a continuidade do negócio mesmo quando as impressoras falham, através de um fallback digital compatível.
Porque é que os programadores utilizam a API de recibos
A API permite-te concentrar-te no teu sistema enquanto a fiskaltrust trata da infraestrutura dos recibos. Em vez de tratar os recibos como uma funcionalidade secundária ou um complemento para o consumidor, a API de recibos trata os recibos como um componente de sistema regulamentado de primeira classe. Integra uma vez e conta com uma API unificada e de código aberto que é mantida à medida que os regulamentos e os requisitos operacionais evoluem.
- Código aberto: Implementação transparente, sem dependência de fornecedores e com total capacidade de auditoria.
- Modelo de recibo unificado: Uma estrutura de dados para itens, pagamentos, impostos, metadados, assinaturas e estados do ciclo de vida.
- Tratamento híbrido de recibos: Recibos digitais e em papel tratados através da mesma API, incluindo HTML, ESC/POS, PDF e formatos nativos de dispositivos.
- Suporte multimercado: As mesmas cargas úteis e lógica de ciclo de vida na AT, DE, FR, IT, ES, PT e muito mais.
- Lógica de conformidade desacoplada: As regras fiscais, os formatos e os mecanismos de assinatura evoluem independentemente do código da aplicação.
- Continuidade do negócio: A criação, assinatura e emissão de recibos permanecem determinísticas e fiáveis em cenários de rede online, offline e degradados.
- Reduz o tempo de integração: Sem renderização de recibos específicos de cada país, lógica de impressão ou fluxos de transporte para manter na tua própria base de código.
- Inclui a visualização de recibos: Documentos de recibo HTML normalizados e compatíveis que funcionam em todos os dispositivos e sistemas operativos.
- Canais de transporte incorporados: Entrega de recibos através de código QR, URL, correio eletrónico, SMS ou transferência de dispositivo, sem lógica de transporte personalizada.
A API de recibos permite que os programadores e revendedores criem uma camada de recibos omnicanal consistente e exponham os dados dos recibos como um serviço reutilizável.
Os recibos tornam-se uma fonte de dados segura e estruturada que pode ser reutilizada em integrações de fidelização, contabilidade e terceiros, transformando as transacções em pontos de contacto extensíveis do sistema em vez de eventos isolados.
Opções de alojamento
Opções de alojamento
- Serviços locais: Windows, Linux, macOS, Android, iOS.
- Centro de dados do comerciante: Clusters Kubernetes ou implementação do IIS.
- Nuvem: Regiões europeias do Azure com conformidade específica do mercado.
- Recusa offline: O corretor IoT local garante que as operações de receção continuam durante as interrupções.
A API de recibos suporta uma implementação flexível. Pode ser incorporada no seu POS, executada como um serviço local, implementada em escala num centro de dados ou utilizada através de serviços de nuvem alojados pela fiskaltrust. Todos os modelos seguem o mesmo contrato API. Os corretores offline garantem que a criação e a assinatura de recibos funcionam mesmo que a ligação à Internet falhe.
Ambiente Sandbox
Podes testar o sistema no nosso ambiente sandbox. Regista-te como parceiro num portal fiskaltrust Market. Amplia o teu endpoint para chamar a API. Este processo permite-te obter dados de recibos no teu formato preferido e visualizá-los.
Como funciona em 3 passos
1.
Inscreve-te no fiskaltrust.Portal.
2.
Cria uma caixa de dinheiro e liga-a ao seu POS ou ERP.
3.
Começa a criar e a emitir recibos com a API de recibos.
Explora mais - Documentação, SDKs e ambientes de teste estão disponíveis aqui