/
Parametrização Integração Mega

Parametrização Integração Mega

São 2 etapas para adicionar a integração Mega para um cliente:

 

Etapa 1: Cadastrar usuário de integração para autenticação da API

  • Vá até Cadastro > Organizadores > Selecione o organizador

  • Clique na aba Operadores

  • Clique no botão Adicionar usuário

  • Preencha:

    • Nome: INTEGRAÇÃO MEGA

    • E-mail: integracao

    • Nível de Acesso: CONVIDADO

    • Login: integracao

    • Senha: Crie uma senha com pelo menos 8 caracteres.
      Não use caracteres especiais.

Anote o usuário e senha para utilizar nas requisições e posteriormente, repassar ao cliente.

 

Etapa 2: Teste de acesso

  • Abra o aplicativo Postman

  • Crie um novo request, marque o mesmo como POST e adicione a seguinte url:

    • https://api.[URL DO CLIENTE].com.br/5.1/totvs/orders

  • Clique na aba Authorization, selecione Auth Type: Basic Auth e adicione:

    • Username: integracao

    • Password: A senha criada no passo anterior

  • Clique na aba Body, adicione 2 parâmetros de data para a pesquisa, no formato YYYY-MM-DD. Exemplo:

    • date_start: 2025-02-01

    • date_end: 2025-02-12

  • Clique em Send

  • O resultado deve ser um JSON com a lista de ‘orders’ do cliente conforme o período filtrado. Ex:

    • { "filters": { "date_start": "2025-01-01", "date_end": "2025-01-12" }, "orders": [ { "id": "423585825", "hash": "09649b3b02efe9c1f836f9ad4f442d1b", "created_at": "2025-01-01", "unit": "Roda Rico", "nsu": null }, { "id": "423585826", "hash": "213cf60bef0181318976a535a393b33d", "created_at": "2025-01-12", "unit": "Roda Rico", "nsu": null } ] }

  • Existe uma segunda rota, para detalhar o pedido:

https://api.[URL DO CLIENTE].com.br/5.1/totvs/order/[ID_PEDIDO]

  • Troque o ID_PEDIDO por algum id devolvido na requisição anterior. Também segue o padrão de autenticação.

  • O restultado deve ser um JSON com os detalhes do pedido, itens e comprador. Ex:

  • { "TPD_IN_CODIGO": 336, "FIL_IN_CODIGO": "4221", "PED_IN_CODIGO": "423585829", "PED_ST_ORIGEM": "TICKETMASTER", "PED_DT_EMISSAO": "12/01/2025", "TRA_IN_CODIGO": 522, "ITEMS": [ { "ITP_IN_SEQUENCIA": 1, "ITP_ST_DESCRICAO": "INGRESSO", "ITP_RE_VALORUNITARIO": "79,99", "ITP_RE_QUANTIDADE": 1, "PRO_ST_ALTERNATIVO": "42615", "ITP_ST_CODPROCLI": "INGRESSO" } ], "FORMAS_PGTO": [ { "PGO_IN_SEQUENCIA": 1, "PGO_ST_PGTO": "SPLIT", "PGO_RE_VALOR": "79,99", "PGO_ST_ORIGEM": "WEB", "PGO_ST_DOCUMENTO": null, "PGO_ST_CODIGO": "AV" } ], "CLIENTE": [] }

Qualquer coisa diferente disso, verifique o endereço correto e/ou o usuário e senha e tipo de autenticação.