Criar Eventos¶
Criar eventos para um ticket¶
Este endpoint permite criar um evento para um determinado ticket
Escopo requerido
Valor | Descrição |
---|---|
open:ticket-events-seller:write |
Permite a utilização das APIs de escrita/atualização. |
Parâmetros da URL
Campo | Tipo | Descrição | Obrigatório |
---|---|---|---|
ticket_uuid |
string | UUID do ticket ao qual o evento pertence. | Sim |
Parâmetros da Requisição
Campo | Tipo | Descrição | Obrigatório |
---|---|---|---|
code |
String | Código opcional para controle do evento pelo usuário | Não |
type |
String | Tipo de evento a ser criado: product_sent , return_info_sent , authorize_refund , product_received , exchange_product_received , refunded , added_bank_account , sla_waiting_customer_expired , rejection_reason , valid_bank_account , waiting_seller_pickup , seller_already_pickedup , waiting_pickup_schedule , sensitive_data_identified , sensitive_data_saved , return_invoice , cancel_invoice , delivery , withdrawn_product , waiting_picked_up , validating_return_invoice , waiting_refund_release |
Não |
Chamada:
curl -X 'POST' \
'https://api.magalu.com/seller/v0/tickets/{ticket_uuid}/events' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Access Token>' \
-H 'Content-Type: application/json' \
-d '{
"code": "codigo_opcional_definido_pelo_usuario",
"type": "product_received"
}'
Campo | Tipo | Descrição |
---|---|---|
transaction_id |
String | Um identificador exclusivo para acompanhar o status da transação. |
links |
List | Uma lista com o endpoint para recuperar o status da transação. |
Resposta:
{
"transaction_id": "2d97892b-50f2-4e0e-8967-3d962c29ade9",
"links": [
{
"path": "/seller/v0/transactions/2d97892b-50f2-4e0e-8967-3d962c29ade9"
}
]
}
Códigos de retorno
Código | Descrição |
---|---|
202 | Accepted |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
500 | Internal Server Error |
Acompanhar finalização da criação da eventos¶
A criação de eventos é um fluxo assíncrono e pode ser acompanhado a partir de transações. Consulte a documentação sobre fluxos assíncronos e transações para entender mais sobre o processo.