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.