Breadcrumbs

ReceiveItems

  • Web Service URL: https://[SERVER_ADDRESS]/StockOrdersWS/StockOrdersData.asmx

  • MPS Versão: A partir da 5.3.0

Descrição

Este método marca como recebido itens de uma entrega que esteja com status Encaminhada ou Em recebimento e foi solicitada ao Centro de Distribuição.

Sintaxe 

public string ReceiveItems(string dealerName, string dealerUserEmail, string dealerUserPassword, int shipmentID, string dateReceived, string utc, string shipmentItemList, string comments)

Parâmetros

  • dealerName: Nome do provedor;

  • dealerUserEmail: E-mail do usuário do provedor;

  • dealerUserPassword: Senha do usuário criptografada;

  • shipmentID: Identificador da entrega onde os itens estão sendo recebidos;

  • dateReceived: Data (Formato: yyyy-MM-dd HH:mm:ss) em que o recebimento real do item ocorreu, a data informada deve estar entre a data em que a entrega foi encaminhada e a data atual, caso contrário irá retornar o erro ERR_SHIPMENT_INVALIDSENTDATE;

  • utc: Valor do UTC da localização referente à data de recebimento do item, que deve ser informado separando as casas decimais com um ponto. Exemplo: -3.0;

    • É importante ficar atendo quanto a variação do UTC caso esteja em horário de verão. Exemplo: No Brasil o UTC normal é -3.0, mas quando está em horário de verão é -2.0.

  • shipmentItemList: Lista com os identificadores (shipmentItemID) dos itens encaminhados que serão recebidos, separados por ";". Exemplo: 15;16;17;

    • Não é necessário informar todos os itens.

  • comments: Informações adicionais sobre o recebimento dos itens da entrega.

Retorno

Clique aqui para saber mais sobre o formato dos retornos.

Obtendo o UTC, exemplo em .NET

  • TimeZone zone = TimeZone.CurrentTimeZone;

  • TimeSpan offset = zone.GetUtcOffset(DateTime.Now);

  • string utc = offset.Hours + "." + offset.Minutes;

Possíveis erros retornados

Clique aqui para verificar os possíveis erros que podem ser retornados e conhecer seus motivos.

Restrições

  • Para executar este método, o usuário informado precisa ser responsável Restrito ou Completo pelo fornecedor (Centro de Distribuição);

  • A entrega deve estar com status Encaminhada ou Em recebimento e o item que vai ser recebido deve estar com status Encaminhado.