Comprar rótulos para envio com o ShipEngine
Made by ShipEngine
Compra um rótulo para envio com base no conteúdo de um documento gravado em uma coleção especificada do Cloud Firestore.
Como esta extensão funciona
Use esta extensão para criar rótulos para envio domésticos dos EUA ou internacionais com o ShipEngine. Integre rapidamente mais de 60 transportadoras para ampliar seu alcance global. Veja a lista completa de transportadoras aqui.
Veja uma gravação de documento básica de exemplo que acionaria esta extensão:
admin .firestore() .collection('shipments') .add({ shipment: { carrierId: 'se-423887', serviceCode: 'usps_media_mail', shipDate: '2021-09-21', validateAddress: 'no_validation', shipTo: { name: 'Amanda Miller', addressLine1: '525 S Winchester Blvd', cityLocality: 'San Jose', stateProvince: 'CA', postalCode: '95128', countryCode: 'US', }, shipFrom: { name: 'John Doe', phone: '111-111-1111', addressLine1: '4009 Marathon Blvd', addressLine2: 'Suite 300', cityLocality: 'Austin', stateProvince: 'TX', postalCode: '78756', countryCode: 'US', }, packages: [ { weight: { value: 1.0, unit: 'ounce', }, }, ], }, });
Outras configurações
Antes de instalar a extensão, verifique se você configurou um banco de dados do Cloud Firestore no projeto do Firebase.
Também é preciso criar uma conta do ShipEngine ou usar uma conta existente e fornecer sua chave de API do ShipEngine da página "ShipEngine API Management" ao configurar a extensão.
Faturamento
Para instalar uma extensão, seu projeto precisa estar no plano Blaze, com pagamento por utilização
- Um pequeno valor será cobrado de você (geralmente cerca de US$ 0,01/mês) referente aos recursos do Firebase exigidos pela extensão, mesmo se não forem usados.
- Esta extensão usa outros serviços do Firebase e do Google Cloud Platform, que têm cobranças associadas caso o nível sem custos seja excedido:
- Cloud Firestore
- Cloud Functions (ambiente de execução Node.js 15+. Consulte as perguntas frequentes)
- Cloud Secret Manager
O uso desta extensão também exige que você tenha uma conta do ShipEngine. Os custos associados ao uso desse serviço são de sua responsabilidade.
Como instalar a extensão
Como usar o Console do Firebase
Para instalar e gerenciar extensões, use o Console do Firebase.
Instalar usando o consoleComo usar a Firebase CLI
Para instalar e gerenciar extensões, também é possível usar a Firebase CLI:
Etapa 1: execute o comando npm (em inglês) a seguir para instalar a CLI ou atualizá-la para a versão mais recente.
npm install -g firebase-toolsNão está funcionando? Consulte a referência da Firebase CLI ou altere suas permissões do npm (em inglês).
Etapa 2: configurar um novo diretório do projeto no Firebase ou acessar um já configurado
Etapa 3: adicionar esta extensão ao seu manifesto de extensões ao ser executada
firebase ext:install shipengine/purchase-labels --local --project=projectId_or_alias
Etapa 4 (opcional): testar a extensão localmente usando o Pacote de emuladores do Firebase
firebase emulators:start
Etapa 5: implantar as extensões do seu manifesto ao projeto
firebase deploy --only extensions --project=projectId_or_alias