Guia de Integração: Ecossistema Londrisoft

Este guia descreve como integrar sistemas ao Ecossistema Londrisoft via API. Ele define responsabilidades, fluxo de entrega e limites de suporte.

Público-alvo: equipe técnica do cliente e parceiros de integração.

Use este artigo quando você quiser:

• conectar um sistema de terceiros ao Londrisoft

• entender o passo a passo até produção

• solicitar campos do produto que não estejam na API

A integração é feita pela sua equipe técnica (ou um parceiro). A Londrisoft disponibiliza APIs de uso geral.

1) Modelo de trabalho

A Londrisoft disponibiliza APIs de uso geral. Isso significa:

• Sem integração nativa com terceiros: a Londrisoft não desenvolve integrações nativas com sistemas de terceiros sob demanda. A integração deve seguir este padrão via API.

• Desenvolvimento externo: a implementação é feita pela sua equipe técnica. Você também pode contratar um terceiro.

• API padronizada: os endpoints e fluxos são globais. Não criamos endpoints ou fluxos dedicados por projeto.

Precisa de algo “exclusivo”? Valide primeiro se já existe no produto. Se existir, siga o processo de solicitação de novos campos.

2) Fluxo de implementação

1

Acesso à documentação e credenciais

Solicite:

• chaves de acesso

• link da documentação técnica (Swagger/Postman)

Documentação da API (Postman): https://documenter.getpostman.com/view/26165125/2sB3QMM9Ht#c4f4de15-2275-4b8a-be8b-714c8c3107ee

2

Desenvolvimento

Seu time técnico faz:

• mapeamento de dados

• implementação dos fluxos

• tratamento de erros e reprocessos

3

Homologação

Teste em ambiente controlado. Valide consistência e completude dos dados.

4

Produção

Ative a integração no ambiente real. Monitore logs e indicadores nas primeiras execuções.

3) Solicitação de novos campos ou funcionalidades

Faltou um campo na API? Se ele já existe no produto Londrisoft, siga este fluxo:

1. Abra um chamado com Atendimento ou CS (Customer Success).

2. Informe qual campo/informação você quer na API.

3. Explique o motivo (caso de uso).

O time de Produto avalia viabilidade e impacto. A API é global.

Resultado da análise

• Aprovado: se priorizado, informamos a previsão de entrega (roadmap).

• Negado: informamos a justificativa com transparência.

4) Suporte técnico

O suporte Londrisoft cobre:

• disponibilidade da API

• dúvidas sobre o comportamento dos endpoints existentes

• correção de instabilidades no serviço de integração

Fora do escopo: lógica de programação. Fora do escopo: configuração de servidores externos. Fora do escopo: linguagens e frameworks de terceiros.