Pular para o conteúdo
platform
PT EN

API da CWS Platform

Desenvolvedores

A API da CWS Platform conecta o seu ERP e os seus sistemas à plataforma: estoque, preço, clientes, crédito e contratos de um lado, pedidos do outro. Esta área organiza a referência pública da API por grupo e por endpoint, e mostra como as chamadas se combinam em uma integração real.

URL base: https://ws.autorei.net · 13 grupos · 78 endpoints

Comece por aqui

Quatro leituras curtas que valem para a API inteira, antes da primeira chamada.

Ambientes e URL base

A URL base, a variável url da coleção e quem chama quem.

Autenticação

Um token por 12 horas, enviado como Bearer em todas as chamadas.

Paginação e limites

limit e offset, tetos por endpoint e as duas rotas de lote.

Erros

Os cinco códigos, os dois formatos de corpo e o 200 parcial.

Casos de uso

Como os endpoints se combinam para resolver uma integração de ponta a ponta.

Integração ERP: o caminho típico pela API

Estoque, preço, clientes, crédito e contratos sobem do ERP; pedidos descem para faturar.

Portal B2B próprio: o caminho típico pela API

O cliente compra sozinho com o preço, o crédito e o estoque que valem para ele, e o vendedor segue no mesmo canal.

Marketplace B2B: o caminho típico pela API

Cada loja integra o próprio estoque, preço e pedidos; o operador consulta o conjunto por rotas próprias.

Varejo complexo e B2B2C: o caminho típico pela API

Empresa e consumidor final no mesmo portal, com preço e estoque por depósito e o balcão ligado ao canal digital.

Compras B2B e suprimentos: o caminho típico pela API

Reposição recorrente sob contrato: preço acordado, crédito, carrinho pronto e acompanhamento item a item.

Venda assistida e balcão: o caminho típico pela API

O vendedor negocia no mesmo portal que o cliente vê, e a integração mantém vendedores, carteiras e carrinhos.

Referência da API

Cada endpoint com método, rota, parâmetros, corpo, respostas, erros e exemplo.

Autenticação

O primeiro passo para consumir os serviços da API CWS é obter um token de acesso. Este token é necessário para autorizar todas as chamadas subsequentes.

1 endpoints

Estoque e Preço

Endpoints dedicados ao gerenciamento completo de estoque e preços dos produtos em seus depósitos.

2 endpoints

Pedidos

Serviços para consulta e gerenciamento de pedidos.

17 endpoints

Clientes

Serviços para gerenciamento completo dos dados cadastrais de clientes, seus endereços e grupos.

13 endpoints

Limite de Crédito

Endpoints para criar e gerenciar tipos de limite de crédito e atribuí-los aos clientes.

3 endpoints

Contratos

Endpoints para gerenciar contratos de preço fixo para clientes ou grupos de clientes.

14 endpoints

Regra de Preço

Serviços para criação e gerenciamento de regras de preço.

3 endpoints

Orçamentos

Serviços para consulta e resposta de orçamentos solicitados por clientes.

5 endpoints

Carrinho Personalizado

Endpoints para criar, editar e deletar carrinhos de compra personalizados para clientes.

3 endpoints

Módulo Vendedor

Endpoints para gerenciar vendedores e suas carteiras de clientes.

7 endpoints

Prioridade de SKU

Endpoints para gerenciar a prioridade de exibição de produtos (SKUs) nos resultados de busca.

5 endpoints

CashBack

Endpoints para consulta de saldos e gerenciamento de cashback de clientes.

5 endpoints

Callbacks e Webhooks

Esta seção documenta as integrações onde a plataforma CWS inicia a comunicação e envia dados para o sistema da sua loja. Diferente das outras seções desta coleção, aqui descrevemos os endpoints que você precisará construir para receber nossas chamadas.

4 eventos

Webhooks e eventos

O que a plataforma envia para o seu sistema, e o que espera de volta.

Webhook assíncrono

Webhook de pedidos

Aviso curto de pedido, com id e status.

Webhook assíncrono

Webhook de pedidos, payload completo

O pedido inteiro no corpo da notificação.

Webhook assíncrono

Webhook de clientes

Cadastro criado ou atualizado na plataforma.

Callback síncrono

Callback de cálculo de impostos

Chamada síncrona: o seu ERP devolve os tributos por item.

Perguntas frequentes

Qual plataforma B2B funciona com SAP e TOTVS?

A API da CWS Platform não depende de um ERP específico: qualquer sistema que faça chamadas HTTP autenticadas e receba webhooks integra. As integrações associadas publicamente incluem SAP, TOTVS, Senior, Sankhya e Microsoft Dynamics.

Como integrar uma plataforma B2B ao TOTVS sem trocar o ERP?

O ERP continua onde está. O integrador autentica na API, envia estoque, preço, clientes, limite de crédito e contratos, recebe os pedidos por webhook e devolve status e nota fiscal. O caso de uso de integração com ERP desta área mostra o caminho típico, endpoint por endpoint.

Integrações associadas publicamente

SAPTOTVSSenior SistemasSankhyaMicrosoft Dynamics 365Microsoft Dynamics

Qualquer outro ERP integra por APIs abertas.

Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.