Leia e registre pedidos a partir do seu sistema ERP Katana
This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Katana ERP to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
Introdução
O Katana é um software ERP (planejamento de recursos empresariais) de manufatura baseado em nuvem para pequenas e médias empresas que buscam uma solução acessível e flexível. O ERP de manufatura Katana oferece uma ampla gama de recursos, desde gestão de estoque e planejamento de produção até gestão de pedidos de vendas e compras de materiais, para otimizar as operações de manufatura de ponta a ponta. O Katana possui vários planos para se adequar ao tamanho e ao nível de maturidade da sua empresa. Ele também oferece um pacote de implementação (mediante taxa adicional) para que você comece a operar rapidamente.O objetivo deste aplicativo é fornecer uma unidade de teste e uma solução MVP que permita que você acompanhe as quantidades das ordens de serviço diretamente do chão de fábrica, bem como as ordens de serviço concluídas. Essa solução e esse conector podem ser ampliados com mais recursos usando o editor de aplicativos e a estrutura de conectores da Tulip.
Objetivo
Vamos destacar diferentes funções do conector que podem ser criadas por meio de chamadas HTTP à API do Katana MRP para interagir com os dados e realizar operações CRUD básicas no Katana. As funções do conector permitem que você obtenha uma lista de ordens de serviço, atualize ordens de serviço etc.
Documentação da API
Documentação da API do Katana MRPVisão geral das APIs do Katana MRP no YouTube
Pré-requisitos
Ter uma conta no Katana e gerar uma chave de API ativa:
- Faça login na sua conta do Katana{target="_blank"}
- Vá para Configurações > API
- Selecione “Adicionar nova chave de API”
Detalhes de conexão do Tulip
As seguintes informações precisam ser configuradas nos conectores do Tulip. Primeiro, nos detalhes da conexão:
- Executando em: Host do conector na nuvem
- Host: api.katanamrp.com
- Porta: 443
- TLS: sim

Em seguida, na visualização de cabeçalhos: 1. Selecione “OAuth 2 (Bearer Token)” 2. Prefixo: “Bearer” 3. Token: insira a chave da API obtida na etapa anterior 4. Adicione um cabeçalho com o nome “Accept” e o valor “application/json” 5. Adicione um cabeçalho com o nome “content-type” e o valor “application/json”

Funções do conector
Listar todas as ordens de produção - sourceRetorna uma lista das ordens de produção que você criou anteriormente. As ordens de produção são retornadas em ordem de classificação, com as mais recentes aparecendo primeiro.
Método: GET
Ponto de extremidade https://api.katanamrp.com/v1/manufacturing\_orders
Parâmetros: N/A
Resultados: A função do conector retorna os detalhes da ordem de trabalho; veja abaixo alguns desses campos: ID da ordem de trabalho, Número da ordem de trabalho, Variante, Data de início programada, Data de vencimento, Status da ordem de trabalho, Quantidade planejada, Quantidade real, Quantidade concluída```
**Listar todas as ordens de produção por status** - [source](https://developer.katanamrp.com/reference/getallmanufacturingorders){target="\_blank"}Retorna uma lista das ordens de produção criadas anteriormente. As ordens de produção são retornadas em ordem de classificação, com as mais recentes aparecendo primeiro.
Método: GET
Ponto de extremidadehttps://api.katanamrp.com/v1/manufacturing_orders?status={status}
ParâmetrosStatus: (texto) um dos status padrão reconhecidos pelo Katana MRP (NOT_STARTED, BLOCKED, IN_PROGRESS, DONE)
Saídas: A função do conector retorna os detalhes da ordem de produção; veja abaixo alguns desses campos: ID da ordem de produção, Número da ordem de produção, Variante, Data de início programada, Data de vencimento, Status da ordem de produção, Quantidade planejada, Quantidade real, Quantidade concluída```
Atualizar uma ordem de produção - sourceAtualiza a produção da ordem de produção especificada, definindo os valores dos parâmetros passados.
Método PATCH
Ponto de extremidadehttps://api.katanamrp.com/v1/manufacturing\_order\_productions/{id}
ParâmetrosID da ordem: (inteiro) ID da ordem de trabalhoStatus: (texto) Novo status da ordem de trabalhoQuantidade real: (inteiro) nova quantidade real da ordem de trabalho
Saídas: A função do conector retorna os detalhes da ordem de produção; veja alguns desses campos: ID da ordem de produção, Número da ordem de produção, Variante, Data de início programada, Data de vencimento, Status da ordem de produção, Quantidade planejada, Quantidade real, Quantidade concluída```
**Recuperar uma produção de ordem de fabricação** - [source](https://developer.katanamrp.com/reference/getmanufacturingorderproduction){target="\_blank"}Recupera os detalhes de uma produção de ordem de fabricação existente com base no ID.
Método: GET
Ponto de extremidadehttps://api.katanamrp.com/v1/manufacturing_order_productions/{id}
ParâmetrosID da ordem: (inteiro) ID da ordem de trabalho
Saídas: A função do conector retorna os detalhes da ordem de produção; veja abaixo alguns desses campos: ID da ordem de produção, Número da ordem de produção, Variante, Data de início programada, Data de vencimento, Status da ordem de produção, Quantidade planejada, Quantidade real, Quantidade concluída```
