Pular para o conteúdo principal

Como obter serviços

📢 Introdução

Os serviços no Cortecloud correspondem aos pedidos no ERP. Assim que um orçamento é gerado no Cortecloud, ele fica acessível para o ERP

Dica

Utilize os exemplos de requisições na documentação de cada rota para facilitar a integração.

📋 Lista de serviços

  • Objetivo: Obter uma lista de serviços
  • Rota: GET /services
  • Passos:
    1. Realize uma requisição para a rota especificada, utilizando os filtros necessários. É extremamente recomendado incluir os parâmetros limit e offset para controlar a quantidade de itens retornados e a página desejada.

    2. Você receberá uma lista com os serviços disponíveis.

    3. Para buscar a próxima página de itens basta atualizar o parâmetro offset na sua próxima requisição para o mesmo valor que o meta.next da resposta anterior.

      Por exemplo: se a resposta da requisição anterior retornar {meta:{next: 10}}, você deve fazer a próxima requisição com offset=10.

    4. Quando a propriedade meta.next retornar null, significa que não há mais itens disponíveis.

    5. Faça a integração com o seu ERP utilizando os dados retornados.

🔍 Detalhes de um serviço

  • Objetivo: Obter detalhes dos itens que compõem um serviço
  • Rota: GET /services/:service_id
  • Passos:
    1. Realize uma requisição para a rota especificada, passando o id do serviço.

    2. Verifique a resposta e utilize os dados conforme necessário.

      O formato da resposta está documentado na documentação da rota.

    3. Caso o serviço não tenha sido encontrado, você receberá um erro 404.