Invia i dati dei pacchi e dei mezzi di trasporto per le spedizioni dirette negli Stati Uniti e nell'Unione Europea.
Due chiamate, uguali per ogni destinazione.
Chiamata↕
Invia↕
Quando↕
brokerageManifestLinesCreate
Pacchi: merci, parti, riferimenti. Massimo 100 per richiesta
All'accettazione del pacco
brokerageManifestCreate
Il mezzo di trasporto, con gli id dei pacchi della chiamata 1
Alla consegna al vettore
Nessuna delle due chiamate blocca l'altra. Usa manifestLinesLink per i pacchi accettati dopo che il mezzo di trasporto è già stato creato.
Conserva l'id restituito dalla chiamata 1: è necessario per la chiamata 2.
Il landed cost viene calcolato in modo asincrono. Una risposta di successo conferma l'accettazione, non la quotazione. I dati degli articoli e delle parti vengono convalidati durante il calcolo, quindi invia i campi indicati di seguito anche quando l'API ne accetta l'assenza.
Deve essere inviato per ogni pacco diretto nell'UE. L'API può accettare un pacco senza di esso, ma la quotazione può risultare errata o non riuscire e la spedizione non è conforme.
Obbligatorio per gli USA
Deve essere inviato per ogni pacco diretto negli Stati Uniti. Senza di esso non è possibile presentare una dichiarazione doganale.
Consigliato
Non necessario per la quotazione, ma utilizzato dalle poste e dalle dogane di destinazione. Invialo ogni volta che è disponibile.
Una parte ORIGIN e una parte DESTINATION. Consulta i campi delle parti.
shippingCost
Obbligatorio per l'UE
Costo di spedizione del pacco. Dazi e IVA UE sono calcolati sul valore CIF, quindi un costo di spedizione mancante viene considerato pari a zero.
shippingCostCurrency
Obbligatorio per l'UE
Valuta di shippingCost. Se omesso, il valore predefinito è USD.
taxIdNumber
Facoltativo
Il numero IOSS, quando la vendita è avvenuta in regime IOSS. Consulta IOSS.
consignmentWeight
Consigliato
Peso lordo del pacco in chilogrammi. Invia lo stesso valore su ogni riga che condivide un numero di tracciamento. Non viene utilizzato per calcolare i dazi.
referenceNumber
Consigliato
Il tuo riferimento univoco per il pacco, utilizzato per evitare duplicati. Consulta Pacchi duplicati.
shipperAccountId
Consigliato
L'ID organizzazione Zonos o il tuo ID esterno per l'account verificato del mittente. Senza di esso il pacco viene attribuito a te anziché al merchant che lo ha spedito.
postalOperatorCode
Facoltativo
Sostituisce il valore predefinito a livello di richiesta nel percorso breve. Ignorato altrove.
declarationId
Facoltativo
Una dichiarazione Zonos già creata per questo pacco. Normalmente viene ricavata dall'ordine.
Campi dell'articolo
Una voce per ogni riga di merci. Un pacco contenente tre classificazioni è un unico pacco con tre voci.
Campo↕
Requisito↕
Note↕
quantity
Obbligatorio
Numero di unità.
countryOfOrigin
Obbligatorio
Codice paese ISO di 2 lettere. Il paese di fabbricazione, non quello di spedizione.
amount
Obbligatorio
Valore unitario. Invia esattamente uno tra amount e totalAmount.
totalAmount
Obbligatorio
Valore complessivo di tutte le unità. Se inviato al posto di amount, il valore unitario è totalAmount / quantity.
description
Obbligatorio
Descrizione semplice delle merci.
measurements
Obbligatorio
Includi una voce di peso netto (WEIGHT per unità o TOTAL_WEIGHT per tutte le unità, non entrambe). Vedi sotto.
hsCode
Obbligatorio per gli USA
Codice HS o tariffario, per riga di merci. Preferibilmente 10 cifre, minimo 6.
customsDescription
Facoltativo
Descrizione specifica per la dogana, quando diversa da description.
provinceOfOrigin
Facoltativo
Provincia o stato di origine, dove richiesto da un paese.
Utilizzato come gtin quando non viene inviato alcun gtin.
name
Facoltativo
Nome breve del prodotto.
documentId
Facoltativo
Collega un documento che hai già caricato.
productComposition
Facoltativo
Materiali che compongono il prodotto. Ogni voce richiede material e percentage.
marketplace
Facoltativo
Marketplace su cui è stato venduto l'articolo, come name e url.
Il codice HS e il paese di origine sono per riga di merci. Un pacco contenente merci con classificazioni diverse richiede un codice e un'origine per ciascuna. Un unico codice per un pacco misto non può essere dichiarato negli Stati Uniti.
Misure. Ogni voce richiede type, unitOfMeasure e value. Il peso è netto e copre tutte le unità di quella riga, quindi non moltiplicarlo per la quantità. È il peso su cui vengono calcolati i dazi.
type: WEIGHT, TOTAL_WEIGHT, VOLUME, LENGTH, WIDTH, HEIGHT o ALCOHOL_BY_VOLUME
Composizione del prodotto. Ogni voce accetta material e percentage, più i campi facoltativi countryOfMeltAndPour, countryOfCast, primaryCountryOfSmelt e secondaryCountryOfSmelt.
Campi delle parti
Ogni parte ha un type (ORIGIN per il mittente, DESTINATION per il destinatario), una person e una location.
Campo↕
Origine (mittente)↕
Destinazione (destinatario)↕
location.countryCode
Obbligatorio
Obbligatorio
location.line1
Obbligatorio
Obbligatorio
location.locality (città)
Obbligatorio
Obbligatorio
location.postalCode
Consigliato
Obbligatorio (eccetto Irlanda)
location.administrativeAreaCode
Facoltativo
Obbligatorio per USA e Canada
person.firstName
Obbligatorio
Obbligatorio
person.lastName
Obbligatorio
Obbligatorio
person.email
Obbligatorio per l'UE
Obbligatorio per l'UE
person.companyName
Facoltativo
Facoltativo
person.phone
Facoltativo
Facoltativo
Entrambe le parti sono indicate nella dichiarazione doganale. Parti incomplete sono la causa più comune di mancato sdoganamento.
I codici postali di origine sono consigliati, non obbligatori: Hong Kong, gli Emirati Arabi Uniti e il Qatar non ne hanno. I codici postali dei destinatari nell'UE sono obbligatori, tranne che in Irlanda.
administrativeAreaCode accetta il codice di due lettere: TX, non TEXAS.
Il PDDP dell'UE prevede sette campi di identificazione del prodotto. Tre vengono alimentati direttamente da ciò che invii sull'articolo, quindi più dati invii qui, più campi della dichiarazione vengono compilati.
Una spedizione via mare utilizza la stessa chiamata con transportationMode: SEA, uno SCAC in carrierCode, il numero di viaggio in serviceNumber, un vesselName e una data di arrivo a settimane anziché a ore di distanza.
Pacchi accettati successivamente
I pacchi accettati dopo la creazione del mezzo di trasporto vengono collegati con manifestLinesLink.
MUTATION
graphql
mutation ManifestLinesLink($manifestId: ID!, $lineIds: [ID!]!){
manifestLinesLink(manifestId:$manifestId, lineIds:$lineIds) {
id
}}
I pacchi non diretti negli Stati Uniti possono saltare il mezzo di trasporto. Passa il codice operatore insieme all'array.
1mutationBrokerageManifestLinesCreate(
2$postalOperatorCode: PostalOperatorCode
3$input: [ManifestLineInput!]!
4){
5 brokerageManifestLinesCreate(
6postalOperatorCode:$postalOperatorCode
7input:$input
8){
9 id
10 trackingNumber
11}
12}
postalOperatorCode fornisce ciò che altrimenti conterrebbe il mezzo di trasporto. Un pacco può sostituire il valore predefinito a livello di richiesta con un proprio valore.
I pacchi diretti negli Stati Uniti richiedono sempre un mezzo di trasporto: la dichiarazione doganale indica il vettore, il servizio e il porto di arrivo.
Invia il numero IOSS in taxIdNumber quando la vendita è avvenuta in regime IOSS.
Formato: IM, un codice di 3 cifre dello stato membro UE, quindi 7 cifre. Esempio: IM5281234567.
Valido: quotato senza IVA all'importazione.
Non valido o assente: quotato con IVA all'importazione. Invia il numero di registrazione oppure ometti il campo. Non inviare numeri progressivi o conteggi di righe.
Valori CIF
Dazi e IVA UE sono calcolati sul valore CIF: merci più spedizione. Invia shippingCost e shippingCostCurrency su ogni pacco diretto nell'UE. Se li ometti, la spedizione viene considerata pari a zero e la quotazione risulta sottostimata.
Parte di destinazione
È obbligatoria una parte DESTINATION con il codice paese del destinatario. Determina quali regole si applicano.
Entrambe le parti richiedono un indirizzo completo: nome, via, località, codice postale, stato, paese. administrativeAreaCode accetta il codice di due lettere dello stato.
Classificazione
È obbligatorio un codice tariffario per ogni riga di merci: preferibilmente 10 cifre, minimo 6. I codici a sei cifre vengono estesi e convalidati. Le righe senza codice non possono essere dichiarate.
Di cosa ci occupiamo noi
Gestiti da Zonos in base alla configurazione del tuo account e alle merci contenute nel pacco:
referenceNumber deve essere univoco tra tutti i tuoi pacchi. Riutilizzarne uno restituisce il record esistente e lo sposta sul nuovo mezzo di trasporto; i relativi articoli e parti non vengono aggiornati. Per correggere un pacco, contatta Zonos anziché inviarlo di nuovo con lo stesso riferimento.
Valori
Invia esattamente uno tra amount e totalAmount per ogni articolo. Inviarli entrambi, o nessuno dei due, fa fallire la quotazione.
currencyCode viene impostato una sola volta per pacco. Tutti i valori degli articoli del pacco lo utilizzano.
Se invii upc senza gtin, l'UPC viene utilizzato come GTIN.
I valori enum sono stringhe semplici, ad esempio "KILOGRAM".
API per le spedizioni postali
Comunica a Zonos le tue spedizioni postali
Invia i dati dei pacchi e dei mezzi di trasporto per le spedizioni dirette negli Stati Uniti e nell'Unione Europea.
Due chiamate, uguali per ogni destinazione.
brokerageManifestLinesCreatebrokerageManifestCreateNessuna delle due chiamate blocca l'altra. Usa
manifestLinesLinkper i pacchi accettati dopo che il mezzo di trasporto è già stato creato.Conserva l'
idrestituito dalla chiamata 1: è necessario per la chiamata 2.Il landed cost viene calcolato in modo asincrono. Una risposta di successo conferma l'accettazione, non la quotazione. I dati degli articoli e delle parti vengono convalidati durante il calcolo, quindi invia i campi indicati di seguito anche quando l'API ne accetta l'assenza.
Alcune destinazioni applicano un supplemento PDDP. Consulta Supplementi PDDP per destinazione.
Le destinazioni diverse dagli Stati Uniti dispongono di un'alternativa con una sola chiamata.
Legenda dei campi
Passaggio 1: comunicaci i dati dei pacchi
Campi del pacco
trackingNumbercurrencyCodeendUseDOCUMENTS,GIFT,FOR_RESALE,NOT_FOR_RESALEoRETURN.itemspartiesORIGINe una parteDESTINATION. Consulta i campi delle parti.shippingCostshippingCostCurrencyshippingCost. Se omesso, il valore predefinito èUSD.taxIdNumberconsignmentWeightreferenceNumbershipperAccountIdpostalOperatorCodedeclarationIdCampi dell'articolo
Una voce per ogni riga di merci. Un pacco contenente tre classificazioni è un unico pacco con tre voci.
quantitycountryOfOriginamountamountetotalAmount.totalAmountamount, il valore unitario ètotalAmount / quantity.descriptionmeasurementsWEIGHTper unità oTOTAL_WEIGHTper tutte le unità, non entrambe). Vedi sotto.hsCodecustomsDescriptiondescription.provinceOfOriginskuproductIdgtinupcgtinquando non viene inviato alcungtin.namedocumentIdproductCompositionmaterialepercentage.marketplacenameeurl.Il codice HS e il paese di origine sono per riga di merci. Un pacco contenente merci con classificazioni diverse richiede un codice e un'origine per ciascuna. Un unico codice per un pacco misto non può essere dichiarato negli Stati Uniti.
Misure. Ogni voce richiede
type,unitOfMeasureevalue. Il peso è netto e copre tutte le unità di quella riga, quindi non moltiplicarlo per la quantità. È il peso su cui vengono calcolati i dazi.type:WEIGHT,TOTAL_WEIGHT,VOLUME,LENGTH,WIDTH,HEIGHToALCOHOL_BY_VOLUMEunitOfMeasure:GRAM,KILOGRAM,OUNCE,POUND,LITER,MILLILITER,CENTIMETER,METER,MILLIMETER,INCH,FOOT,YARDoPERCENTAGEComposizione del prodotto. Ogni voce accetta
materialepercentage, più i campi facoltativicountryOfMeltAndPour,countryOfCast,primaryCountryOfSmeltesecondaryCountryOfSmelt.Campi delle parti
Ogni parte ha un
type(ORIGINper il mittente,DESTINATIONper il destinatario), unapersone unalocation.location.countryCodelocation.line1location.locality(città)location.postalCodelocation.administrativeAreaCodeperson.firstNameperson.lastNameperson.emailperson.companyNameperson.phoneEntrambe le parti sono indicate nella dichiarazione doganale. Parti incomplete sono la causa più comune di mancato sdoganamento.
I codici postali di origine sono consigliati, non obbligatori: Hong Kong, gli Emirati Arabi Uniti e il Qatar non ne hanno. I codici postali dei destinatari nell'UE sono obbligatori, tranne che in Irlanda.
administrativeAreaCodeaccetta il codice di due lettere:TX, nonTEXAS.Esempio
mutation BrokerageManifestLinesCreate($input: [ManifestLineInput!]!) {brokerageManifestLinesCreate(input: $input) {idtrackingNumberreferenceNumbertaxIdNumber}}RISPOSTA
json
{ "data": { "brokerageManifestLinesCreate": [ { "id": "line_abc123def456", "trackingNumber": "RB123456799GB", "referenceNumber": "ITM-00184413", "taxIdNumber": "IM5281234567" } ] } }Identificativi prodotto
Quattro campi su ogni riga di merci.
productIdskugtinmanufacturerProductIdCome li utilizza l'Europa
Il PDDP dell'UE prevede sette campi di identificazione del prodotto. Tre vengono alimentati direttamente da ciò che invii sull'articolo, quindi più dati invii qui, più campi della dichiarazione vengono compilati.
merchantProductIdentifier(MPID)productId, in alternativaskumanufacturerStandardizedProductIdentifier(S PID)gtinmanufacturerNonStandardizedProductIdentifier(NS PID)manufacturerProductIdlccProviderProductIdentifierviene impostato a partire dal nostro id articolo.manufacturerIdentifiernon viene inviato.Vincoli:
gtincontiene solo cifre.05012345678900, non0-50123-45678-9.gtinoupc, non entrambi. Un UPC è un GTIN-12;upcviene normalizzato ingtin.manufacturerProductIdconsente 70 caratteri. Tutti gli altri campi identificativi vengono troncati a 50.Passaggio 2: comunicaci i dati del mezzo di trasporto
Inviati alla consegna al vettore, indicando gli id dei pacchi del passaggio 1.
postalOperatorCodecarrierCodeserviceNumberarrivalDatedestinationCodetransportationModeAIR,SEA,ROADoRAIL. Il valore predefinito èAIR.vesselNameoriginCodeawbPrefixawbNumberweightweightUnitweight.amountLa lettera di vettura aerea è facoltativa. La chiave del mezzo di trasporto viene ricavata da
carrierCode,serviceNumbere dalla data.Invia
destinationCodeeoriginCodenel formato che utilizzi già. Zonos gestisce la mappatura con gli elenchi dei porti doganali.mutation BrokerageManifestCreate($input: ManifestInput!, $lineIds: [ID!]!) {brokerageManifestCreate(input: $input, lineIds: $lineIds) {idcarrierCodeserviceNumberdestinationCodearrivalDate}}Una spedizione via mare utilizza la stessa chiamata con
transportationMode: SEA, uno SCAC incarrierCode, il numero di viaggio inserviceNumber, unvesselNamee una data di arrivo a settimane anziché a ore di distanza.Pacchi accettati successivamente
I pacchi accettati dopo la creazione del mezzo di trasporto vengono collegati con
manifestLinesLink.MUTATION
graphql
mutation ManifestLinesLink($manifestId: ID!, $lineIds: [ID!]!) { manifestLinesLink(manifestId: $manifestId, lineIds: $lineIds) { id } }Un percorso più breve per l'Europa
I pacchi non diretti negli Stati Uniti possono saltare il mezzo di trasporto. Passa il codice operatore insieme all'array.
mutation BrokerageManifestLinesCreate($postalOperatorCode: PostalOperatorCode$input: [ManifestLineInput!]!) {brokerageManifestLinesCreate(postalOperatorCode: $postalOperatorCodeinput: $input) {idtrackingNumber}}postalOperatorCodefornisce ciò che altrimenti conterrebbe il mezzo di trasporto. Un pacco può sostituire il valore predefinito a livello di richiesta con un proprio valore.I pacchi diretti negli Stati Uniti richiedono sempre un mezzo di trasporto: la dichiarazione doganale indica il vettore, il servizio e il porto di arrivo.
Note sui dati per l'UE
IOSS
Invia il numero IOSS in
taxIdNumberquando la vendita è avvenuta in regime IOSS.Formato:
IM, un codice di 3 cifre dello stato membro UE, quindi 7 cifre. Esempio:IM5281234567.Valori CIF
Dazi e IVA UE sono calcolati sul valore CIF: merci più spedizione. Invia
shippingCosteshippingCostCurrencysu ogni pacco diretto nell'UE. Se li ometti, la spedizione viene considerata pari a zero e la quotazione risulta sottostimata.Parte di destinazione
È obbligatoria una parte
DESTINATIONcon il codice paese del destinatario. Determina quali regole si applicano.Note sui dati per gli USA
Parti complete
Entrambe le parti richiedono un indirizzo completo: nome, via, località, codice postale, stato, paese.
administrativeAreaCodeaccetta il codice di due lettere dello stato.Classificazione
È obbligatorio un codice tariffario per ogni riga di merci: preferibilmente 10 cifre, minimo 6. I codici a sei cifre vengono estesi e convalidati. Le righe senza codice non possono essere dichiarate.
Di cosa ci occupiamo noi
Gestiti da Zonos in base alla configurazione del tuo account e alle merci contenute nel pacco:
Note generali
Pacchi duplicati
referenceNumberdeve essere univoco tra tutti i tuoi pacchi. Riutilizzarne uno restituisce il record esistente e lo sposta sul nuovo mezzo di trasporto; i relativi articoli e parti non vengono aggiornati. Per correggere un pacco, contatta Zonos anziché inviarlo di nuovo con lo stesso riferimento.Valori
amountetotalAmountper ogni articolo. Inviarli entrambi, o nessuno dei due, fa fallire la quotazione.currencyCodeviene impostato una sola volta per pacco. Tutti i valori degli articoli del pacco lo utilizzano.upcsenzagtin, l'UPC viene utilizzato come GTIN."KILOGRAM".Questa pagina è stata utile?