A entidade Status de Pedido Customizado permite que a empresa personalize os status utilizados no ciclo de vida dos pedidos no Mercos.
Com esse recurso, é possível criar status adicionais além dos padrões do sistema — Em Orçamento, Concluído e Cancelado — possibilitando um gerenciamento por etapas mais alinhado ao processo interno da empresa.
Esses status personalizados podem representar fases específicas do seu processo comercial, por exemplo: Aguardando Aprovação, Separação de Estoque, Em Transporte, entre outros.
Observação: Status marcados como excluídos não estarão disponíveis para seleção nos pedidos.
Estrutura da Resposta (GET)
| Campo | Tipo | Descrição |
|---|---|---|
| id | Integer | Identificador único |
| nome | String: 100 | Nome do status |
| ultima_alteracao | DateTime | Data e hora da última modificação deste status no Mercos |
| excluido | Boolean | Indica se o status está excluído |
Parâmetros de Envio (POST / PUT)
| Campo | Tipo | Descrição |
|---|---|---|
| nome (obrigatório) | String: 100 | Nome do status |
| excluido | Boolean | Indica se o status deve ser marcado como excluído. |
Após a criação dos Status de Pedido Customizados, é possível vinculá-los aos pedidos através da API, permitindo que cada pedido seja associado a uma etapa específica do processo comercial da empresa.
Além da atualização do status atual do pedido, a API também disponibiliza a consulta do histórico de alterações, possibilitando acompanhar toda a evolução do pedido dentro do fluxo personalizado definido pela empresa.
Estrutura da Resposta (GET - Histórico de Status)
| Campo | Tipo | Descrição |
|---|---|---|
| id | Integer | Identificador único |
| status_id | Integer | Identificador único do status customizado |
| status_nome | String: 100 | Nome do status |
| data_criacao | DateTime | Data e hora da criação deste status no pedido |
| anotacao | String: 5000 | Campo para especificações do status vinculado ao pedido. |
Parâmetros de Envio (POST - Vinculo no pedido)
| Campo | Tipo | Descrição |
|---|---|---|
| status_id (obrigatório) | Integer | Identificador único do status customizado |
| anotacao | String: 5000 | Campo para especificações do status vinculado ao pedido. |