Requisitos DSP
Requisitos Funcionais
ID | Tipo | Requisito |
|---|---|---|
1 | Obrigatório | O access_token deve ser atualizado automaticamente a cada 90 minutos |
2 | Obrigatório | O API de Autenticação do Revendedor access_token e refresh_token devem ser salvos e usados por todos os usuários que têm permissão para gerenciar pedidos de peças. |
3 | Obrigatório | O API de Autenticação do Revendedor access_token deve ser atualizado a cada 2 horas usando o refresh_token. |
4 | Obrigatório | O revendedor deve validar (Validar serviço) antes de enviar (Criar serviço) o pedido de peças. |
5 | Obrigatório | As mensagens de aviso e erro retornadas pelo serviço Validar e Criar devem ser exibidas ao revendedor. |
6 | Obrigatório | Um pedido de peças criado deve ser atualizado chamando o serviço Get para recuperar as informações mais recentes até que o pedido seja enviado. O serviço Get pode ser chamado quando o revendedor exibe o pedido de peças ou periodicamente em segundo plano. |
7 | Obrigatório | O código de status 504 Gateway Timeout deve ser gerenciado chamando o serviço Check até que o pedido de peças seja criado para os serviços Create e Validate. |
8 | Obrigatório | Os métodos de envio disponíveis para o revendedor devem ser obtidos do API de Concessionárias. O método de envio padrão deve ser o primeiro retornado pelo API de Concessionárias. |
9 | Obrigatório | O revendedor deve ser capaz de cancelar um ou vários itens de linha em um pedido de peças se o pedido não estiver completo ou enviado. |
10 | Obrigatório | O DMS deve usar o serviço Get para realizar um carregamento inicial, recuperar todos os pedidos de peças dos últimos 90 dias e salvá-los no banco de dados do DMS. Se um pedido de peças foi criado em seu DMS, o pedido de peças deve ser atualizado com as novas informações recebidas através da API de Pedido de Peças. Se o pedido de peças não existir, ele deve ser criado no seu DMS. |
11 | Obrigatório | O serviço Get deve ser usado diariamente para recuperar o pedido de peças dos últimos 30 dias e salvá-los no banco de dados DMS. Se um pedido de peças foi criado em seu DMS, o pedido de peças deve ser atualizado com as novas informações recebidas através da API de Pedido de Peças. Se o pedido de peças não existir, ele deve ser criado no seu DMS. |
12 | Obrigatório | O revendedor deve ser capaz de encontrar um pedido de peças usando um número de entrega. |
13 | Obrigatório | O revendedor deve ser capaz de encontrar um pedido de peças usando um número de fatura. |
14 | Opcional | O revendedor pode encontrar um pedido usando o número de rastreamento da transportadora. |
15 | Opcional | O revendedor pode carregar manualmente os pedidos de peças fornecendo um intervalo de datas. |
16 | Obrigatório | Para cada pedido de peça, as seguintes informações específicas da BRP devem estar disponíveis para o revendedor:
|
17 | Obrigatório | Quando um pedido de peças é exibido, o shipping_lines campo deve ser mostrado ao usuário. O ordered_lines campo também pode ser exibido, mas o DMS deve mostrar claramente que o revendedor receberá as peças listadas no shipping_lines campo. |
18 | Opcional | O revendedor deve ser capaz de recuperar um único pedido de peças usando o número do pedido de venda. Seu DMS deve estar chamando o Obter Pedido endpoint. |
19 | Opcional | O revendedor deve ser capaz de recuperar resumos de pedidos de peças. Nesse caso, seu DMS deve estar chamando o Obter Pedidos endpoint usando o resumo parâmetro. |
Atividades de Certificação
Esta seção apresenta todas as atividades de certificação e validações que devem ser concluídas para certificar a API.
Garantia de Qualidade
Os testes listados na tabela abaixo devem ser concluídos com sucesso no ambiente de teste antes que você possa iniciar a fase piloto do revendedor.
👉 Para executar os testes, você precisa das credenciais de revendedor BOSSWeb no ambiente de teste. Se você não as tiver, abra um ticket no Jira do DCP.
ID | Teste | Resultado Esperado |
|---|---|---|
1 | Verifique os métodos de envio disponíveis para o revendedor no DMS. | Os métodos de envio devem ser os mesmos que o retornado pelo API de Concessionárias e o padrão deve ser o primeiro retornado na resposta. |
2 | Valide um pedido de peças com 20 peças válidas e exiba as mensagens de aviso e erro. | O pedido de peças é válido, sem mensagem de aviso ou erro. |
3 | Validar um pedido de peças com uma peça descontinuada (1301200012). Exiba as mensagens de aviso e erro. | O pedido de peças é inválido, e a mensagem de erro é exibida. |
4 | Validar um pedido de peças com 45 itens. Chame o serviço de Verificação até que o pedido seja validado. | O pedido de peças é válido, sem mensagem de aviso ou erro. |
5 | Valide e crie um pedido de peças com 20 peças válidas e exiba as mensagens de aviso e erro. | O pedido de peças foi criado e exibido. |
6 | Obtenha o pedido de peças criado e exiba o resultado. | O pedido de peças está exibido. |
7 | Crie um pedido de peças com 45 peças válidas. Chame o serviço de Verificação até que o pedido seja criado. | O pedido de peças foi criado e exibido. |
8 | Chame o serviço Obter Pedidos para recuperar os pedidos de peças criados nos últimos 7 dias. | Os pedidos de peças foram carregados em seu DMS. A equipe DCP compara os pedidos de peças com os encontrados no BOSSWeb. |
9 | Chame o serviço Obter Pedidos para recuperar os pedidos de peças em andamento. | Os pedidos de peças foram carregados em seu DMS. |
10 | Crie um pedido de peças com 1 item. Assim que o pedido for criado, cancele o item. | O item da linha e o pedido estão cancelados. |
11 | Valide e crie um pedido de peças com as seguintes peças:
| O pedido é válido e criado com mensagens de aviso. |
12 | Valide um pedido de peças com uma peça em uma linha de produtos não suportada pelo revendedor. | A mensagem de erro é exibida. |
13 | O serviço Get é chamado diariamente para recuperar os pedidos de peças | Os pedidos de peças dos últimos 30 dias estão carregados no banco de dados |
14 | Chame o Obter Pedido para obter um pedido específico usando o número do pedido de venda. (Opcional) | O pedido de peças está carregado no seu DMS. |
15 | Chame o serviço Obter Pedidos para recuperar os resumos dos pedidos de peças criados nos últimos 7 dias. (Opcional) | Os pedidos de peças estão carregados no seu DMS. |
Piloto de Revendedor
A tabela abaixo descreve os parâmetros e validações do piloto do revendedor.
Parâmetro | Valor |
|---|---|
Ambiente | Produção |
Número de revendedores | 1 a 3 |
Duração | 1 a 3 semanas |
Validação 1 | Verifique se os pedidos de peças com mais de 25 itens de linha são criados. |
Validação 2 | Verifique se os pedidos de peças criados estão atualizados para exibir as informações de entrega. |
Validação 3 | Você envia um relatório toda semana mostrando os pedidos de peças criados para cada revendedor no piloto. O relatório deve mostrar o pac_order_id e o sales_order_id. |
Validar 4 | Realize uma demonstração ao vivo da função de pedido de peças em seu DMS em um dos concessionários do piloto. |
Validação 5 | Verifique se os pedidos de peças dos últimos 90 dias estão carregados. |
Validação 6 | Verifique se os pedidos de peças dos últimos 30 dias estão atualizados diariamente. |