快工助手跨境电商知识与商机助手

[BR] Atualização de Validação de IE para Endereço de Coleta

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/changelogtopic/developertopic/uncategorized

资料正文

§1 [BR] Atualização de Validação de IE para Endereço de Coleta

Olá Desenvolvedores,

Para ajudar os vendedores BR com CNPJ a garantir que seu endereço de coleta seja consistente com informações válidas de Inscrição Estadual (IE), a Shopee irá aprimorar a lógica de validação de IE para cenários relacionados ao endereço de coleta. Esta atualização adiciona novas mensagens de erro de validação de IE para ajudar a reduzir problemas de processamento de documentos fiscais eletrônicos e de fulfillment causados por informações tributárias ausentes, inválidas ou inconsistentes.

Quando vendedores BR com CNPJ chamarem v2.logistics.update_address ou v2.logistics.set_address_config para adicionar ou atualizar um endereço de coleta, as seguintes mensagens de erro serão retornadas caso o estado do endereço não possua um registro de IE válido, caso o status da IE encontrada seja inválido, ou caso o estado do Endereço de Coleta não corresponda às informações de KYC / IE do vendedor, respectivamente:

Error MessageDescription
BR pickup address SRN record not found.O vendedor não possui um registro de IE válido para o estado do endereço de coleta selecionado.
BR pickup address SRN is invalid.O registro de IE foi encontrado, mas seu status atual é inválido.
BR pickup address state does not match SRN.O estado do endereço de coleta não corresponde ao estado da IE do vendedor.

Nota: Esta atualização apenas adiciona novas mensagens de erro para validação via API. Não há alterações nos parâmetros de requisição, parâmetros de resposta ou na estrutura de campos de v2.logistics.update_address e v2.logistics.set_address_config.

Recomenda-se que os desenvolvedores otimizem sua lógica de tratamento de erros com base nas mensagens acima e orientem os vendedores a verificar se o endereço de coleta e as informações de IE estão consistentes.

APIs relacionadas:

v2.logistics.update_address

V2.logistics.set_address_config

Caso haja qualquer dúvida sobre a utilização do endpoint estamos disponíveis para solucioná-las via nossa plataforma de tickets.

Atenciosamente,

Equipe Shopee Open API Brasil

#