Gerenciar recursos das lojas

Recursos são funcionalidades cobradas à parte ou incluídas no plano da loja. Os incluídos já vêm ativos; os adicionais (inclusionType: ADDITIONAL no plano) são contratados e cancelados por aqui.

Ação	Endpoint	Sucesso
Ativar recursos	`POST /partner/v2/merchants/{merchantId}/features/activate`	`202`
Cancelar recursos	`POST /partner/v2/merchants/{merchantId}/features/cancel`	`202`

Os dois recebem a lista de recursos e respondem com o ID da loja:

string[]

obrigatório

Um ou mais tipos de recurso.

Resposta (202)

{ "merchantId": "d7240afd-d47c-4ae8-b79d-f14d3e8e1dd8" }

Ativar Recursos

curl --request POST 'https://api.deliveryvip.com.br/partner/v2/merchants/{merchantId}/features/activate' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{ "feature": { "featureTypes": ["DELIVERYBOT_NOTIFICATION", "INDOOR_QRCODE"] } }'

await fetch(`https://api.deliveryvip.com.br/partner/v2/merchants/${merchantId}/features/activate`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ feature: { featureTypes: ['DELIVERYBOT_NOTIFICATION', 'INDOOR_QRCODE'] } }),
})

requests.post(
    f"https://api.deliveryvip.com.br/partner/v2/merchants/{merchant_id}/features/activate",
    headers={"Authorization": f"Bearer {token}"},
    json={"feature": {"featureTypes": ["DELIVERYBOT_NOTIFICATION", "INDOOR_QRCODE"]}},
)

Recursos já contratados são ignorados. Os erros vêm com 406 Not Acceptable:

`title`	Causa
`Invalid featureType`	Lista vazia ou tipo desconhecido.
`Feature type not exists in plan`	O plano da loja não tem preço para os recursos pedidos.
`Merchant does not have a valid license`	A loja não está em `TRIAL`, `DEMO` ou `ACTIVATED`, está bloqueada, ou o parceiro ou a revenda dela está com teste expirado, bloqueado ou cancelado.
`Feature type is hidden`	O recurso foi ocultado para essa loja.

Cancelar Recursos

Mesmo corpo, em features/cancel.

curl --request POST 'https://api.deliveryvip.com.br/partner/v2/merchants/{merchantId}/features/cancel' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{ "feature": { "featureTypes": ["INDOOR_QRCODE"] } }'

Erros, também com 406:

`title`	Causa
`Invalid featureType`	Lista vazia ou tipo desconhecido.
`Feature type is included in plan`	O recurso faz parte do plano e não pode ser cancelado sozinho.
`Feature type not hired`	O recurso não está contratado.

Um recurso cancelado aparece como CANCELLED até o fim do mês (ou por 24 horas) e depois volta a AVAILABLE. Recontratar dentro desse período não muda a data de contratação. Veja Status dos recursos.

Sobre os recursos

Recurso	Descrição
`DELIVERYBOT_NOTIFICATION`	Mensagens no WhatsApp sobre o status do pedido para o cliente. Saiba mais.
`DELIVERYBOT_ASSISTANT`	Pré-atendimento ao cliente no WhatsApp. Saiba mais.
`INDOOR_VIEWER`	Cardápio por QR Code no local, só para visualização.
`INDOOR_QRCODE`	Cardápio por QR Code no local, com pedidos pelo celular do cliente.
`INDOOR_TABLET`	Tablet no local para o cliente fazer pedidos.
`DOMAIN_CUSTOM`	Domínio personalizado para a loja.
`GROWTH_DISCOUNT`	Módulo de descontos.
`INTEGRATION_MARKETING`	Integrações de marketing.
`INTEGRATION_LOGISTIC`	Integrações de logística.

Visão geral

Lojas

Revendas

Planos

Faturas

Cadastro

Referência

Ativar Recursos

Cancelar Recursos

Sobre os recursos

​Ativar Recursos

​Cancelar Recursos

​Sobre os recursos

Ativar Recursos

Cancelar Recursos

Sobre os recursos