Trade Documents Upload API
Bevezetés
A Kereskedelmi dokumentumok feltöltése API megoldást kínál a nemzetközi FedEx-küldemények szállítási dokumentumainak feltöltésére, leegyszerűsíti a globális szállítási igényeit, és lehetővé teszi a nemzetközi küldeményekhez szükséges vámdokumentumok elektronikus feltöltését. A legtöbb kereskedelmi dokumentumot elektronikusan is benyújthatja, így nem kell kinyomtatnia vagy csatolnia a kereskedelmi dokumentumokat a küldeményhez.
A vámhatóságok és más szervek gyorsabban megkapják az elektronikusan elküldött dokumentumokat, mint a küldeményhez csatolt, papíralapú példányokat. A vámkezelési folyamat is optimalizálódik, mivel az elengedhetetlen kereskedelmi információk rögzítése és megosztása a szállítás korábbi szakaszaiban történik.
Megjegyzés:
- Bizonyos esetekben egyes nemzetközi dokumentumok eredeti példányait továbbra is csatolni kell a csomaghoz. További tájékoztatásért olvassa el az Kiviteli dokumentumok című szakaszt.
- A zökkenőmentes vámkezelés és a késedelmek elkerülése érdekében győződjön meg arról, hogy a dokumentumok vizuálisan tiszták és semmilyen módon nem torzítottak.
A Kereskedelmi dokumentumok feltöltése API részletei
Töltse fel vámdokumentumait, vagy használja a FedEx által létrehozott kereskedelmi dokumentumokat. Testre is szabhatja a FedEx által generált elektronikus kereskedelmi dokumentumokat a vállalata levélpapírjának/logójának és a digitális aláírásképének feltöltésével. Amennyiben a dokumentumokat elektronikusan tölti fel, akkor nem kell minden egyes küldemény esetén kézzel aláírnia, összehajtogatnia, bezacskóznia és a küldeményhez csatolnia a vámdokumentumokat. Ezen felül papírt, energiát és nyomtatási költséget takaríthat meg.
A következő funkciók kapcsolódnak ehhez az API-hoz:
Dokumentum feltöltése
A dokumentumokat feltöltheti egyesével a küldemény létrehozása előtt (a küldemény rendszerben történő feladása előtt) vagy a küldeménynek a Fuvarozási API használatával történő létrehozása után (küldemény feladása után).
Megjegyzés: Az említett küldemény-létrehozás a Fuvarozási API-n belüli küldemény, valamint nyitott küldemény rendszerben történő rögzítésére és teheráru-küldemény végpontok létrehozására vonatkozik.
Több dokumentum feltöltése
Feltöltési kérésenként legfeljebb öt dokumentumot tölthet fel mind a feladás előtti, mind a feladás utáni feltételekhez.
Több titkosított dokumentum feltöltése
Feltölthet több, akár öt base64 titkosítású dokumentumot is egyszerre a küldemény létrehozása előtt (küldemény feladása előtt) vagy a küldemény létrehozása után (küldemény feladása után). Az ezzel az opcióval feltöltött dokumentumok további biztonságot nyújtanak a dokumentumadatoknak egy valószínűtlen adatszerzés esetén.
Képek feltöltése
Ez a funkció lehetővé teszi, hogy egyedi céges levélpapírt/logót és digitális aláírási képeket töltsön fel, amelyeket a FedEx által generált papírokon vagy jelentésekben használhat. Először töltse fel a céges levélpapírt/logót és a digitális aláírás képét a FedEx szerverére, majd adja meg ezeket a feltöltési hivatkozásokat a szállítási kérelemben (Küldemény létrehozása végpont) az egyes dokumentumokhoz a customerImageUsages elem használatával, amely a shippingDocumentSpecification alatt található.
A digitális aláírások vagy levélpapírok/céges logók a következő FedEx által generált dokumentumokra és jelentésekre lesznek rányomtatva:
- Kereskedelmi számla
- Származási bizonyítvány
- OP900
- Pro-forma számla
- USMCA szerinti származási bizonyítvány
- USMCA szerinti kereskedelmi számla és származási bizonyítvány
Megjegyzés:
- Digitális aláírás – Az aláírás maximális mérete 240x25 pixel, és a képek csak GIF és PNG formátumúak lehetnek.
- Céges levélpapír/logó – A logó maximális mérete 700x50 pixel, és a képek csak GIF és PNG formátumúak lehetnek.
A Kereskedelmi dokumentumok feltöltése API munkafolyamata
Az alábbiakban bemutatjuk a dokumentum feltöltésének folyamatát aszerint, hogy arra a feladás előtt vagy után kerül sor.
Küldemény feladása előtti dokumentumfeltöltés:
A küldemény feladása előtti dokumentumfeltöltés magában foglalja a dokumentum(ok) feltöltését ezzel az API-vel a küldemény létrehozása előtt. Sikeres dokumentumfeltöltés után a feltöltött dokumentumhivatkozást később a feladási kérelemhez társíthatja.
Ez a szokásos módszer a kereskedelmi dokumentumok feltöltésére a küldemény visszaigazolása előtt.
A küldemény feladása előtti dokumentumfeltöltés lépései a következők:
- Használja a következő végpontok bármelyikét az igényeinek megfelelően
- Dokumentum feltöltése
- Több dokumentum feltöltése
- Titkosított dokumentumok feltöltése
- A workflowName értékre válassza az ETDPreShipment lehetőséget annak jelzésére, hogy ez egy küldeményfeladás előtti feltöltés.
- Adja meg a feltölteni kívánt tényleges fájl(ok)at vagy base64 titkosítású dokumentumokat.
- Adja meg azokat a dokumentumadatokat (kereskedelmi számla, származási bizonyítvány, kiviteli nyilatkozat stb.), amelyek magukban foglalják a dokumentumtípust, valamint a dokumentumhoz kapcsolódó fuvarozási metaadatokat.
- A sikeres kérelem feltölti a dokumentumokat a FedEx szerverére, és sikertokenként visszaküldi az egyes feltöltött dokumentumok egyedi azonosítóját, azaz a docId azonosítót.
- Használja a Küldemény létrehozása/Nyitott küldemény létrehozása/Teheráru-küldemény végpontot.
- A Fuvarozás végpontban az Ön által kiválasztott shipmentSpecialService/specialServiceTypes elemben adja meg az ELECTRONIC_TRADE_DOCUMENTS értéket, és másolja át a docId érték(ek)et a SpecialServices/etdDetail/attachedDocuments/documentId elemre. Megjegyzés: Több darabból álló küldemény (MPS) esetén adja meg a dokumentum feltöltéséből származó docId azonosítót a küldemény összes csomagjára vonatkozóan.
- A sikeres feladási kérelem megerősíti az ETD-küldeményt a FedEx számára, és létrehozza a nyomonkövetési és címkeadatokat, az completedEtdDetail objektum pedig visszaadja a feltöltött dokumentumtípust és a dokumentum(ok) azonosítóját hivatkozásként.
- A feladás előtti dokumentumfeltöltésnél az összes dokumentumot egyenként vagy 5 dokumentumig együttesen is feltöltheti, majd az összes dokumentum azonosítóját egyszerre adhatja meg a küldeményhez.
Küldemény feladása utáni dokumentumfeltöltés (PSDU):
A küldemény feladása utáni dokumentumfeltöltés (PSDU) lehetővé teszi a dokumentum(ok) feltöltését a küldeményigénylés beküldése és a nyomonkövetési címkék generálása után. Ebben az esetben amint létrehozták a küldeményfeladást, és a rendszer nyomonkövetési számot generál, társítsa ezt a számot a dokumentumfeltöltési kérelemhez.
Ez a módszer kényelmes azon ügyfelek számára, akik saját kereskedelmi számlákat állítanak ki, és harmadik felek vagy távoli irodák készítik számukra a vámdokumentációt.
A következő fontos szempontokat ne feledje, amikor ezt a módszert használja:
- A küldemény nyomonkövetési számának és a küldemény dátumának készen kell állnia a feltöltési kérelem előtt.
- Tisztában kell lennie a feladó helyszínének FELADÁSI határidejével ahhoz, hogy időben beküldje a dokumentációt.
Ez az API támogatja a jövőbeni és az aktuális napi küldemények vámdokumentumának benyújtását is.
A küldemény feladása utáni dokumentumfeltöltés lépései a következők:
- Használja a Küldemény létrehozása/Nyitott küldemény létrehozása/Teheráru-küldemény végpontot.
- A Küldemény létrehozása végpontban adja meg az alábbi részleteket a kiválasztásnak megfelelően,
- Adja meg a shipmentSpecialServices/specialServiceTypes elemet az ELECTRONIC_TRADE_DOCUMENTS értékként.
- A shipmentSpecialServices/etdDetail/attributes elemre válassza a POST_SHIPMENT_UPLOAD_REQUESTED lehetőséget.
- A sikeres szállítási kérelem megerősíti a küldeményt a FedEx számára, és létrehozza a nyomonkövetési és címkézési adatokat.
- Használja a következő végpontok bármelyikét az igényeinek megfelelően.
- Dokumentum feltöltése
- Több dokumentum feltöltése
- Több titkosított dokumentum feltöltése.
- Adja meg a workflowName értéket ETDPostShipment értékként annak jelzésére, hogy ez egy küldeményfeladás utáni feltöltés.
- Adja meg a feltölteni kívánt tényleges fájl(ok)at vagy base64 titkosítású dokumentumokat.
- Adja meg azokat a dokumentumadatokat (kereskedelmi számla, származási bizonyítvány, kiviteli nyilatkozat stb.).
- Adja meg a már feldolgozott küldemény nyomonkövetési számát és a feladás dátumát a document/meta/trackingNumber elem és a document/meta/shipmentDate elem alatt.
Megjegyzés: Több darabból álló küldemények (MPS) esetén a dokumentumok feltöltésekor használja a fő fuvarlevélszámot. A főküldeményre megadott ETD-részletek az alküldeményre is érvényesek. - A sikeres kérelem feltölti a dokumentumokat a FedEx szervereire, és a feltöltött dokumentumokat a küldeményhez társítja
A következők a Kereskedelmi dokumentumok feltöltése API funkciói. Ez lehetővé teszi a küldemény dokumentációja szempontjából releváns dokumentumok és képek feltöltését.
Trade Documents Upload API (1.0.2)
Response