Estrela Connect — CDW Loja Virtual

Integração CDW - LOJA VIRTUAL → Estrela Manipulação

Configure a URL do webhook para onde os pedidos pagos serão enviados automaticamente no formato da API Estrela Manipulação.

URL do Webhook

Endpoint que receberá o POST com os dados do pedido

Token de autenticação (Bearer)

Token Sanctum da API Estrela

Prefixo do pedido

Ex: pedido #1042 → EC-1042

Tentativas em caso de falha

Meta key do CPF/CNPJ

Chave do meta_data onde o CPF/CNPJ é salvo no pedido (ex: _billing_cpf, _billing_cnpj)

Enviar automaticamente ao mudar para "Processando"

Mapeamento automático dos campos da CDW - LOJA VIRTUAL para o formato da API Estrela Manipulação.

CDW - Loja Virtual	Estrela	Transformação	Exemplo
`order.number`	`numero_pedido`	Prefixo "EC-" + número	EC-1042
`order.total`	`valor`	Direto	189.90
`order.discount / subtotal`	`desconto_percentual`	Calcula % sobre subtotal	10
`order.payment_method`	`forma_pagamento`	Mapeamento customizado	pix
`billing.first + last_name`	`cliente_nome`	Concatenação	Maria Silva
`billing.phone`	`cliente_telefone`	Direto	(45) 99999-8888
`billing.address + city…`	`cliente_endereco`	Formatação completa	Rua X, 123 - Centro…
`meta_data._billing_cpf`	`cliente_cpf_cnpj`	Meta key configurável	123.456.789-00
`line_items[].name + qty`	`descricao_formula`	Lista de produtos	Vitamina D x2, Omega 3 x1
`customer_note`	`observacoes_internas`	Direto	Entregar na portaria

CDW - Loja Virtual (payment_method)	→	Estrela (forma_pagamento)
`pix`	→	`pix`
`bacs`	→	`transferencia`
`cod`	→	`dinheiro`
`credit_card`	→	`cartao_credito`
`debit_card`	→	`cartao_debito`
`boleto`	→	`boleto`

Exemplo de JSON enviado

{
  "numero_pedido": "EC-1042",
  "valor": "189.90",
  "desconto_percentual": 10,
  "forma_pagamento": "pix",
  "cliente_nome": "Maria Silva",
  "cliente_cpf_cnpj": "123.456.789-00",
  "cliente_telefone": "(45) 99999-8888",
  "cliente_endereco": "Rua Exemplo, 123 - Centro, Cascavel - PR, 85800-000",
  "descricao_formula": "Vitamina D 2000UI x2, Omega 3 1000mg x1",
  "observacoes_internas": "Entregar na portaria",
  "status": "producao"
}

Enviados hoje

Com sucesso

Com erro

Callbacks recebidos

Pedido	Data	Cliente	Valor	Status	Resposta
`EC-1042`	09/06/2026 14:32	Maria Silva	R$ 189,90	Enviado	200 OK
`EC-1041`	09/06/2026 13:15	João Santos	R$ 342,50	Concluído	Callback recebido
`EC-1040`	09/06/2026 11:48	Ana Oliveira	R$ 78,00	Erro	Timeout - tentativa 2/3
`EC-1039`	08/06/2026 17:22	Carlos Pereira	R$ 256,00	Enviado	200 OK
`EC-1038`	08/06/2026 16:05	Fernanda Lima	R$ 410,75	Concluído	Callback recebido
`EC-1037`	08/06/2026 14:50	Roberto Almeida	R$ 125,00	Enviado	200 OK
`EC-1036`	08/06/2026 10:33	Patrícia Costa	R$ 567,20	Concluído	Callback recebido

O plugin expõe um endpoint REST para receber callbacks da Estrela. Quando a Estrela fatura um orçamento, ela chama este endpoint e o pedido na CDW - LOJA VIRTUAL muda para "Concluído".

Endpoint do callback

POST https://seusite.com.br/wp-json/estrela-woo/v1/callback

Headers necessários

Authorization: Bearer {token_configurado}
Content-Type: application/json

Body esperado da Estrela

{
  "numero_pedido": "EC-1042",
  "status": "faturado",
  "timestamp": "2026-06-09T15:30:00Z"
}

O que o plugin faz ao receber

Valida o token de autenticação

Busca o pedido pelo numero_pedido (remove prefixo EC-)

Verifica se o status atual é "processing"

Atualiza para "completed" e adiciona nota no pedido

Retorna 200 OK com confirmação

Resposta de sucesso

{
  "success": true,
  "message": "Pedido EC-1042 atualizado para concluído",
  "order_id": 1042
}

Token de segurança do callback

Compartilhe este token com a equipe da Estrela para configurar o callback