Executa uma ação na reclamação

POST 
/hub/order/claim/:idhuborderclaim/action

Executa uma das ações listadas em AvailableActions pelo detalhe da reclamação. O código da ação vai em Type na query e o corpo muda conforme a ação. Para anexar arquivos, envie antes cada um no endpoint de anexo da reclamação e repasse em Attachments os FileUUID recebidos. Type=AvailableActions não executa nada: apenas consulta no canal a lista de ações disponíveis no momento e a devolve. Omitir Type equivale a enviar um código inválido e a chamada é recusada. Disponível apenas para reclamações do Mercado Livre. Nas demais ações, ao final devolve a linha de staging já atualizada com o novo estado da reclamação.

Request

Responses

200

Com Type diferente de AvailableActions: o pedido recarregado no mesmo formato de GET /hub/order/{idintegration} — um array de HubOrderDetailItem já com a reclamação atualizada.

Com Type=AvailableActions: um array de objetos { Mandatory, IDTypeHubOrderClaimActionExternalId, TypeHubOrderClaimActionDescription }, sem os campos extras (PartialRefundOffers, ReturnFailReasons, OptionsList).

400

Mensagens (prefixo [BadRequest]):

• Pedido não encontrado no hub — reclamação inexistente ou de outra empresa.
• Integração não tem envio de mensagem — a integração informada não é de canal de vendas (por exemplo, integrações de transportadora ou de adquirente).
• Integração não tem consulta de status — o canal de vendas existe, mas não trata reclamações; hoje apenas o Mercado Livre trata.

Recusas do canal, repassadas com o mesmo prefixo:

• Recurso de reclamação não existe — Type omitido ou sem correspondência com nenhuma ação suportada.
• Necessário enviar a mensagem, campo 'Text' — em send_message_to_complainant, send_message_to_mediator, send_message_to_respondent e send_attachments.
• Necessário enviar o campo 'Text' e 'Reason' — em return_review_fail.
• Necessário enviar a mensagem, campo 'Percentage' — em allow_partial_refund.
• Necessário enviar a mensagem, campo 'EstimatedShippingDate' — em send_potential_shipping.
• Necessário enviar o campo 'EstimatedShippingDate' — em add_shipping_evidence e send_tracking_number.