Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

É recomendado ter por requisição até no máximo 200 operações para um melhor desempenho da API.

Parâmetros obrigatórios: 

  • customerSite- texto com o nome do site, local da operação.

  • customerTimeWindows- é a janela de horário que o cliente poderá receber a operação. É possível definir mais de uma janela horária. Parâmetros obrigatórios:

    • start- Horário de início que o cliente atua na operação. Formato timestamp: 1511901826456.

    • end- Horário de fim que o cliente atua na operação. Formato timestamp: 1511904661038.

  • depotSite- depot de origem para a operação. Usado para identificar de qual depot o produto será embarcado no veículo até a entrega. No caso de operação de coleta, o depot onde será descarregado o produto.

  • id- texto único com o identificador da operação. Normalmente é a ordem de serviço ou algum id de fácil identificação em outros sistemas.

  • product- texto único com o nome do produto. Deve estar declarado em products.

  • type- tipo da operação, de entrega do produto ou coleta do produto. Deve ser um dos seguintes tipos: [ COLLECTION, DELIVERY ].

  • volume- número decimal com o volume do produto que será entregado/coletado na operação. É importante estar na mesma unidade em que foi utilizado em vehicleTypes. Por exemplo, metros cúbicos.

  • weight- número decimal com o peso do produto que será entregado/coletado na operação. É importante estar na mesma unidade em que foi utilizado em vehicleTypes. Por exemplo, kilogramas.

...

Code Block
languagejson
"operations": [
    {
        "customerSite": "MERCADO02GLICERIO",
        "depotSite": "DEPOSITO01",
        "type": "DELIVERY",
        "customerTimeWindows": [
            {
                "start": 1583499600000.
                "end": 1583506800000                
            },
            {
                "start": 1583499600000 1583510400000.
                "end": 1583528400000
            }
        ],
        "id": "NUMORDEM30",
        "product": "HD_DIVERSOS",
        "volume": 1,
        "weight": 0.15
    },
    {
        "customerSite": "MERCADO10SCAETANO",
        "depotSite": "DEPOSITO01",
        "type": "DELIVERY",
        "customerTimeWindows": [
            {
                "end": 1583528400000,
                "start": 1583492400000
            }
        ],
        "id": "NUMORDEM27",
        "product": "HD_DIVERSOS",
        "volume": 1,
        "weight": 0.15
    }
]

...

  • customerHandlingDuration- Número inteiro com o tempo em segundos que será gasto no cliente para realizar a operação. Conforme o tipo de atividade, se acumula ao tempo declarado nos parâmetros siteLoadingFixedTime e siteUnloadingFixedTime de LogisticConstraints.

  • depotTimeWindows- é a janela de horário do depósito em que a operação deve ocorrer. Por exemplo, se for uma operação com atividade de delivery, o produto será carregado no veículo dentro do depósito neste intervalo de horário (na resposta da API aparecerá como Loading). Se for uma operação com atividade de collection, o produto chegará no depósito neste intervalo de horário (na resposta da API aparecerá como Unloading):

    • start- Horário de início que o depot atua na operação. Formato timestamp: 1511901826456.

    • end- Horário de fim que o depot atua na operação. Formato timestamp: 1511904661038.

  • depotHandlingDuration- Número inteiro com o tempo em segundos que será gasto no depot para realizar a operação. Conforme o tipo de atividade, se acumula ao tempo declarado nos parâmetros siteLoadingFixedTime e siteUnloadingFixedTime de LogisticConstraints.

  • group- Texto com o grupo de operações. Usado para agrupar operações de forma manual. As operações que possuem o mesmo valor serão executados juntos.

  • preAllocatedVehicleName- Texto com o nome do veículo que irá realizar a operação de forma pré-definida. Com isso a Planning API irá alocar esse veículo associado para colocar a operação em sua rota. Utilize esse parâmetro para exemplos em que um motorista favorito deverá atender um cliente ou um veículo específico precisa realizar a operação.

  • priority- Número inteiro da prioridade da operação. A escala de prioridade pode ser crescente ou decrescente que deve ser configurado no parâmetro priorityManagementType com DECREASING_MANAGEMENT ou GROWING_MANAGEMENTdo Optimization Profile.

  • quantity- Número decimal com a quantidade da operação. Apenas para descrição, não interfere no peso ou volume da operação, ou no modo em que a operação é processada.

...