Webservice V1
Frete e chip físico

Frete e chip físico

Além do eSIM, você pode vender chip físico (type: "chip").

O que muda no chip físico

AspectoeSIMChip físico
typeesimchip
Identificador técnicoeid (QR Code gerado)icc (impresso no chip)
EntregaDigital (QR Code)Física
eSIM não tem frete
A entrega do eSIM é digital, via QR Code retornado na ativação. O frete só se aplica ao chip físico.

Consultar o frete

GET /get-tax/{uf} retorna o valor do frete para um estado. O {uf} é a sigla do estado (por exemplo SP).

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

A resposta traz as duas modalidades dos Correios:

json
{ "sedex": 13, "pac": 5.9 }
CampoDescrição
sedexValor do frete via Sedex (mais rápido).
pacValor do frete via PAC (mais econômico).

Criar a ativação de chip físico

Ao criar um chip físico, o corpo do POST /activations é o mesmo do eSIM — mudando o type para chip e informando o icc do chip:

json
{
  "type": "chip",
  "dateActive": "2026-05-10",
  "idProduct": 90,
  "items": [ { "sequence_item": 411 } ],
  "chips": [ { "icc": "8955XXXXXXXXXXXXXXXX" } ],
  "name": "João Silva",
  "email": "joao.silva@example.com",
  "phone": "(11) 98765-4321",
  "document": "182.177.290-34"
}

Próximos passos