Webservice V1
Produtos e operadoras

Produtos e operadoras

Antes de criar uma ativação, você precisa saber o que vender: qual operadora, qual produto e por qual preço. Estes endpoints listam esse catálogo — é o ponto de partida do fluxo de ativação.

O catálogo é específico da sua agência
Um produto só aparece se estiver liberado para a sua agência. Por isso, consulte sempre o catálogo pela API em vez de fixar IDs e valores no seu código.

Operadoras

GET /operators retorna as operadoras disponíveis para a sua agência.

bash
curl --request GET \
  --url 'https://portal.woo-fi.com/api/webservice/v1/operators' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {seu-token}'

Cada operadora traz idOperator e description:

json
[
  { "idOperator": 14, "description": "T-Mobile" },
  { "idOperator": 15, "description": "WOOFI" }
]

Produtos

GET /products retorna os produtos que você pode vender. Cada produto traz idProduct e description — o idProduct é o que você informa ao criar o pedido.

bash
curl --request GET \
  --url 'https://portal.woo-fi.com/api/webservice/v1/products' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {seu-token}'
json
[
  { "idProduct": 1, "description": "Product 1" },
  { "idProduct": 2, "description": "Product 2" }
]

Itens e preços de um produto

Um produto pode ter vários itens (planos/opções), cada um com seu preço. Consulte-os com GET /product-items/{productId}/0:

bash
curl --request GET \
  --url 'https://portal.woo-fi.com/api/webservice/v1/product-items/44/0' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {seu-token}'
json
[
  {
    "options_sequence": 956,
    "price": 24,
    "sequence": 1991,
    "optionName": "First Option",
    "itemName": "30 DIAS",
    "idProduct": 44
  }
]
O options_sequence é o que você ativa
O campo options_sequence (o identificador da variação) é o valor que você informa em items[].sequence_item ao criar a ativação. Guarde-o junto com o idProduct.

O segundo segmento da rota (/0 no exemplo) é a sequência-pai para itens aninhados; use 0 quando não houver aninhamento.

Todos os preços de uma vez

Para montar uma tabela completa de preços sem varrer produto a produto, use GET /product-items/all, que retorna todos os itens disponíveis (idProduct, description, sequence, price, itemName).

O identificador da variação muda de nome aqui
Neste endpoint, o valor que você passa em sequence_item vem no campo sequence (por rota /product-items/{productId}/0, o mesmo valor está em options_sequence). Em ambos, é o id da variação.
bash
curl --request GET \
  --url 'https://portal.woo-fi.com/api/webservice/v1/product-items/all' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {seu-token}'

Próximos passos