Saltar para o conteúdo
Tejobit
Logótipo Jasmin

Faturação

Integração Jasmin

Encomendas, faturas e recebimentos entram no Jasmin a partir da loja, do Stripe ou de um portal, sem lançamentos manuais.

Pedir esta integração Ver todas as integrações

Visão geral

Jasmin

O Jasmin é o software de gestão cloud da Cegid Primavera para pequenas e médias empresas: vendas, compras, inventário, tesouraria e faturação certificada no browser. Muitas empresas chegam ao Jasmin vindas do Primavera e mantêm a mesma lógica de artigos, clientes e séries.

A API do Jasmin é REST e está organizada por conta, subscrição e módulo: vendas, compras, contas a receber, contas a pagar, logística, inventário, impostos e dados mestre. Cada recurso tem criação, atualização, anulação, leitura e listagem paginada, e o acesso é autorizado por OAuth 2.0, através de uma aplicação registada para a subscrição.

A Tejobit usa essa estrutura para colocar cada evento no módulo certo. Uma encomenda online entra como encomenda de venda, um pagamento confirmado gera o recebimento em contas a receber, e a fatura sai do Jasmin, que a emite e comunica à AT.

Casos de uso

Para que serve

  • Empresa de software que fatura no Jasmin as subscrições cobradas pelo Stripe.
  • Grossista com portal B2B em que as encomendas dos revendedores entram diretamente nas vendas do Jasmin.
  • Loja online que mostra o stock real dos armazéns geridos no Jasmin.
  • Empresa de serviços que regista no Jasmin os recebimentos de transferências identificadas pelo banco.
IN

O que a ligação escuta

  • Pagamento confirmado no Stripe ou noutro gateway.
  • Encomenda criada na loja online ou no portal B2B.
  • Listagem agendada no Jasmin para detetar faturas novas ou alterações de stock.
  • Cliente novo criado no CRM.
OUT

O que a ligação faz

  • Cria ou atualiza clientes nos dados mestre do Jasmin.
  • Cria encomendas de venda e faturas com os artigos e as taxas de IVA definidos no Jasmin.
  • Regista recebimentos em contas a receber, ligados às faturas que liquidam.
  • Lê quantidades em armazém e atualiza a loja online.
  • Devolve o número e o estado do documento ao sistema de origem.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Subscrição Jasmin ativa e os identificadores da conta e da subscrição a integrar.
  • Aplicação registada para acesso à API, com as credenciais entregues à Tejobit.
  • Artigos, clientes e séries de documentos já criados no Jasmin, ou regras para os criar.
  • Mapeamento entre os meios de pagamento do gateway e os do Jasmin.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A API do Jasmin não garante avisos em tempo real para todos os eventos; o que muda dentro do Jasmin é lido por listagens paginadas a intervalos definidos.
  • Cada empresa corresponde a uma conta e subscrição; grupos com várias empresas precisam de uma configuração por empresa.
  • A ligação segue o modelo de dados do Jasmin: artigos, clientes e taxas têm de existir antes de serem usados num documento.

Perguntas frequentes

Antes de começar

O Jasmin é o mesmo que o Primavera?

Não. Ambos são da Cegid Primavera, mas o Jasmin é cloud e tem uma API própria. O Primavera ERP é instalado localmente e integra-se de outra forma.

A integração cria lançamentos contabilísticos?

Cria os documentos de venda e os recebimentos; a contabilização segue as regras configuradas no Jasmin e o trabalho do contabilista.

Quem comunica as faturas à AT?

O Jasmin, como software certificado. A ligação só cria os dados que o Jasmin usa para emitir o documento.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Jasmin?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com