integração com a API da teceo
encontre no manual:
- o que é a API da teceo?
- como funciona a integração com a API?
- o que pode ser integrado?
- como é o fluxo de integração
- principais vantagens da integração com a API teceo
- acompanhamento da integração
- documentação técnica
1. o que é a API da teceo?
a API da teceo permite que você integre seus sistemas internos (ERP) diretamente à plataforma da teceo, garantindo que os dados de sua operação estejam sempre atualizados e conectados. através dela, você pode realizar operações de leitura e escrita para sincronizar informações essenciais.
2. como funciona a integração com a API?
- ambiente único e seguro: a teceo utiliza um único ambiente de homologação e produção para todos os clientes. apesar de compartilhado, ele é isolado por marca e login, garantindo a segurança e individualidade de cada integração.
- liberação de chave de acesso: para conectar-se à API, são liberadas chaves de acesso configuradas de acordo com os recursos que serão integrados (clientes, pedidos, produtos, estoques, entre outros). exemplo: se a integração envolver apenas pedidos, liberamos acesso exclusivo a este módulo. caso surjam novas necessidades, as permissões podem ser incrementadas.
- responsabilidade do cliente: a partir da liberação da chave, a responsabilidade pela construção e implementação da integração é do cliente e de sua equipe de t.i. o cliente é responsável por:
- planejar a integração,
- criar a comunicação entre seus sistemas e a API,
- realizar os testes necessários em conjunto com a equipe teceo.
3. o que pode ser integrado?
a API da teceo permite integrar as seguintes entidades principais:
- clientes: integração de dados cadastrais dos clientes entre ERP e teceo.
- produtos: sincronização de produtos e suas relações (ex.: tamanhos e cores) do ERP para a teceo.
- estoques: controle de estoque pronto e estoque futuro entre ERP e teceo.
- pedidos: sincronização de pedidos entre ERP e teceo.
além desses recursos principais, a API oferece funcionalidades adicionais de suporte às integrações, conforme as necessidades da operação.
4. como é o fluxo de integração?
a) definição de escopo:
- a equipe da teceo libera as chaves de acesso conforme os módulos solicitados e contratados pelo cliente.
- o cliente e sua equipe técnica definem as entidades a serem integradas e os requisitos técnicos necessários.
b) desenvolvimento da integração:
- o cliente desenvolve a comunicação entre seus sistemas e a API da teceo, utilizando as credenciais fornecidas.
c) operações disponíveis:
a API da teceo permite realizar operações unidirecionais, ou seja, de leitura e escrita na plataforma:
-
- leitura: consultar recursos (ex.: listar clientes cadastrados na teceo).
- escrita: inserir informações (ex.: cadastrar produtos do ERP na teceo).
5. principais vantagens da integração com a API teceo:
- automação e sincronização eficiente dos dados.
- maior flexibilidade para integrar diferentes entidades conforme sua necessidade.
- redução de erros manuais e retrabalhos.
- total controle e autonomia do cliente para desenvolver e gerenciar a integração.
6. acompanhamento da integração:
na teceo, é possível que você acompanhe o andamento e status da sincronização de produtos. para isso, siga os passos abaixo:
1. no menu lateral acesse configurações.
2. em regras de negócio clique em integrações.
3. na tela de integrações, localize o integrador.

4. por fim, clique na aba importações, onde poderá validar as últimas importações de produtos executadas.
7. documentação técnica:
para detalhes completos sobre os endpoints, métodos disponíveis e exemplos de requisições, acesse o nosso Swagger através do link: [Swagger].
caso tenha dúvidas durante o processo de integração, nossa equipe de suporte estará disponível para auxiliar.