Mudanças em APIs do Logistics

por: Ronan Cruz   June 8, 2016 13:20 em Engineering

No dia 10/08/2016, impreterivelmente, faremos alterações no funcionamento de algumas APIs do módulo Logistics visando manter maior controle na monitoria e estabilidade de nossos sistemas.

Essas alterações se aplicam às APIs que permitem consultar ou atualizar estoque de uma lista de SKUs em uma mesma chamada. São elas:

Consultar:

  • POST: api/logistics/pvt/inventory/warehouseitems/balance
  • GET : api/logistics/pvt/inventory/balance?ids={idsSku}
  • POST: api/logistics/pvt/inventory/warehouseitems/getbalance
  • POST: api/logistics/pvt/inventory/itemsbalance List<ItemBalance>

Atualizar:

  • POST: api/logistics/pvt/inventory/warehouseitems/setbalance
  • POST: api/logistics/pvt/inventory/balance
  • POST: api/logistics/pvt/inventory/warehouseitembalances

As APIs continuarão existindo e os objetos de entrada e saída permanecerão os mesmos, a única diferença é que a lista de SKUs que atualmente é ilimitada será diminuída e validada para aceitar apenas um SKU. Apenas as chamadas com mais de um SKU serão recusadas.

Sugerimos aos que realizam as chamadas com mais de um SKU  que passem a fazê-la em paralelo, ou seja, se seu processo é realizar 1 chamada com 10 SKUs passe a realizar 10 chamadas simultâneas com apenas 1 SKU.

Essas limitações serão aplicadas no dia 11/07/2016, portanto pedimos que as adequações sejam realizadas o quanto antes afim de que se evite maiores problemas.

PS: Neste link uma coleção do POSTMAN com as APIs que sofrerão alterações.

Obs.: Houve uma alteração na data das alterações das APIs do dia 11/07/2016 para o dia 10/08/2016.

Gostou? Estamos contratando!

  • Alejandro Osorio (BlackSip)

    Hola,

    Me parece muy mal hecho que no comuniquen bien este cambio. A nosotros en BlackSip (agencia partner) nos avisaron hasta hoy. Ademas que tambien hay otro cambio muy sutil que no informan, y es que el servicio para actualizar inventario ya no es POST, ahora va a ser un PUT.

    • Ronan Cruz

      Olá, Alejandro Osorio.

      Você poderá continuar usando a mesma API e o objeto de entrada não será alterado, justamente para minimizar impacto de desenvolvimento. A única diferença será que o array de skus esperado não será mais ilimitado, ele deverá ser um array com apenas 1 elemento.

      A data dessa alteração foi postergada, agora será aplicada em 30/06.

    • Ronan Cruz

      Olá Alejandro,

      Você poderá continuar usando a mesma API e o objeto de entrada não será alterado, justamente para minimizar impacto de desenvolvimento. A única diferença será que o array de skus esperado não será mais ilimitado, ele deverá ser um array com apenas 1 elemento.

      A data dessa alteração foi postergada, agora será aplicada em 30/06.

      • Alejandro Osorio (BlackSip)

        Hola Ronan,

        Pero también cambia el verbo http, cierto? Antes era POST y ahora va a ser PUT.
        También la url cambia. Adjunto imágenes de la documentación.

        Saludos!

        • Ronan Cruz

          Alejandro, você pode continuar utilizando o método antigo, com POST. Este método não será removido nem o objeto de entrada será alterado, a única mudança será que passaremos a validar o tamanho do array passado na chamada, que deverá conter no máximo 1 elemento.

          De preferência utilize o segundo método, com PUT, mas não haverá problema se continuar utilizando o método antigo passando apenas 1 sku no array de entrada.

          • Alejandro Osorio (BlackSip)

            Hola Ronan,

            Clarisimo. Usare el antiguo con POST, con un solo elemento en el Array.

            Saludos!

  • Rômulo Martins

    Olá,

    Isso vai interferir também no Serviço em SOAP??

    Desde já agradeço;