Magis5

objetivo o conector magis5 integra a plataforma fluid à api pública do magis5 , permitindo consultar e enviar pedidos, produtos, notas fiscais, etiquetas, anúncios e canais de venda é direcionado a clientes e equipes de suporte , oferecendo sincronização completa de dados de e commerce entre o magis5 e sistemas conectados via fluid doc oficial da api (callout archbee) \ https //developers magis5 com br/docs/magis5 public/802bo3bosw7wq como consigo um token para integrar a api magis5 \ https //app magis5 com br/v1/ui/index html requisitos (criando conexão campo tipo obrigatório descrição x magis5 apikey string (secreto) sim chave de autenticação fornecida pela magis5 deve ser inserida no header das requisições autenticação a autenticação é feita exclusivamente via chave de api , passada no header x magis5 apikey {sua chave magis5} observações de segurança o campo é marcado como fld secret true e não é exibido em logs ou interfaces públicas a chave é gerada e controlada pelo próprio magis5 recomenda se armazenar o valor em variáveis seguras (vault) e revisar periodicamente sua validade configurando um fluxo formato application/json paginação via \ limit e \ page filtros parâmetros como \ status, \ timestampfrom, \ timestampto, \ structuretype, \ enablelink autenticação header x magis5 apikey validação todos os campos obrigatórios devem seguir o schema ambientes definidos pela própria chave de api (sandbox ou produção) recursos e operações principais recursos suportados recurso operações disponíveis descrição orders get /orders, get /orders/\ completeordernumber, post /orders, put /orders/\ completeordernumber, patch /orders/\ completeordernumber criação, consulta e atualização de pedidos order detail required get /orders/details/required/queues consulta de detalhes obrigatórios de pedidos fulfillment get /fulfillments/queues, post /fulfillments/queues/read controle de filas fulfillment invoices get /invoices/queues, post /invoices/\ completeordernumber, get /invoices/documents/queues envio e leitura de notas fiscais products get /products, post /products, put /products/\ sku, patch /products/\ sku criação e atualização de produtos ads get /ads/\ sku, put /ads/prices/\ sku consulta e atualização de anúncios labels get /labels/queues, get /labels/\ completeordernumber consulta e consumo de etiquetas channels get /channels, get /channels/\ channel listagem e pesquisa de canais de venda providers get /providers consulta de fornecedores callback put /callbacks/stocks atualização de estoque via callback health get /health verificação do status da api na prática boas práticas sempre incluir o header x magis5 apikey validar a chave antes da execução testar primeiro com chamadas de leitura (get) disparando o fluxo modos de execução manual, evento externo ou agendamento validação sucesso indicado por http 200 ou 201; falhas retornam http 4xx/5xx testes recomendados get /health para validar comunicação get /orders?limit=1 para confirmar acesso autenticado conclusão o conector magis5 permite integração completa com os recursos principais da api magis5 (pedidos, produtos, notas fiscais, anúncios e canais) o modelo de autenticação via api key simplifica a configuração e garante segurança, sem necessidade de autenticação via login