Bloodweb CSV Exporter for Australia Post
| 开发者 | bloodweb |
|---|---|
| 更新时间 | 2026年11月1日 16:35 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Whole-centimetre dimensions. Australia Post rejects any dimension with more than 4 integral digits or more than one decimal place, which a calculated measurement such as 9.18 or 13.65 trips instantly.
- Item weight never below the declared contents. On international manifests each content line is rounded up to the 0.001 kg floor, so a parcel of many sub-gram pieces can declare more across its contents than the order weighs. That is rejected with "the input shipment request is invalid for item content weight". The exported weight is always the larger of the two.
- Customs values of at least 1. Free lines and fully discounted lines would otherwise trigger "Parcel Contents - Value is in error".
- Minimal quoting. PHP's own CSV writer quotes any field containing a space, which produces a header row Australia Post cannot match against its required column names. This plugin quotes a field only when the value truly needs it.
- The Schedule 8 declaration. Australia Post requires every domestic parcel to state whether it contains Schedule 8 or medicinal cannabis. Leave the column out and the upload still succeeds, but MyPost asks for the answer again the moment you open an order to edit it, one order at a time.
- A SKU on every EU customs line. Australia Post makes the content SKU mandatory for EU member countries and rejects the row without it: "Parcel Contents - SKU is in error. Missing value for mandatory field SKU." Every line carries its product's SKU, a variation falling back to its parent's, and a product with no SKU at all to the id WooCommerce knows it by.
- 10-digit HS codes for the United States. Australia Post no longer accepts US-bound parcels with a 6 or 8-digit code. When an export includes US orders and your store-wide code is shorter than 10 digits, a notice says so beside the download buttons, until you dismiss it.
- The customer's own choice, read from the order and from the order's shipping line, so a flag attached to the chosen shipping method is picked up either way.
- Any shipping method you list as requiring a signature, for services where the signature is a property of the rate rather than a customer choice.
- Your configured default.
apcsv_content_line (one customs content line, with its item, product
and order), apcsv_order_description, apcsv_order_edn, apcsv_customs_missing,
apcsv_delivery_address, apcsv_order_signature and
apcsv_signature_meta_keys. Actions: apcsv_export_ready (the export notice is
about to show) and apcsv_exported (a manifest was written).
Links
- Plugin page and version history at bloodweb.net, including downloadable sample manifests
- Full documentation
- Jack Ewers, who builds it
安装:
- Install and activate the plugin. WooCommerce must be active.
- Go to WooCommerce > Settings > Shipping > AusPost CSV Exporter.
- Fill in your sender ("Send From") details. These are deliberately empty on a fresh install, and the export refuses to run until Name, Address Line 1, Suburb, State and Postcode are set, rather than producing a manifest with no return address.
- Set your package defaults: description, parcel length and width, minimum height, packing efficiency and minimum weight.
- If you ship internationally, set your customs defaults: item description, HS tariff code, Export Declaration Number, reason for export and country of origin. These are also empty on a fresh install, and international exports wait until the item description, HS tariff code and EDN are set. Domestic exports are not held up.
屏幕截图:
常见问题:
Do I need a paid Australia Post account?
You need whatever account you already use for bulk lodgement, typically MyPost Business. The plugin produces the file; it does not talk to Australia Post.
Why is the export refusing to run?
Your sender details are not set. A manifest with no return address is rejected on upload, which you would only discover after switching tabs and trying to lodge, so the plugin stops earlier and links you to the settings screen. If only the International download is missing, your customs details are not set. Every customs declaration needs an item description, an HS tariff code and an Export Declaration Number, and no default is true for every store.
What HS tariff code should I use?
The one that describes what you sell. There is no general-purpose code. Parcels to the United States need the full 10 digits (see the next question). The same code written with dots, for example 7117.90.00, is accepted in the Export Declaration Number column.
Why do parcels to the United States need a 10-digit HS code?
Since 24 July 2026 Australia Post no longer accepts 6 or 8-digit HS codes on US-bound parcels, and those parcels may be returned. This plugin writes your one store-wide HS tariff code into every customs line, so if everything you send to the US shares a 10-digit code, enter it in the settings and you are done. If your products need different codes, the Pro add-on sets them per product, variation or category. When an export includes US orders and the store-wide code has fewer than 10 digits, the plugin shows a notice with the download buttons. It appears only there, and never again for you once dismissed.
Why does EU customs reject my item description?
The EU's ICS2 customs system rejects vague descriptions such as "goods", "merchandise", "general merchandise", "gifts", "items", "various" or "misc". Describe what is actually in the parcel, for example "stainless steel earrings". That is why the item description is empty on a fresh install and international exports wait until you set one.
Why did my EU orders fail with "Parcel Contents - SKU is in error"?
Australia Post makes the SKU mandatory on every customs line bound for an EU member country and rejects the row without one. Parcels to the US and the rest of the world import either way, which is why one file can go through except for its European rows. From 4.4.0 the column is written, so re-export those orders and upload again. The SKU comes from the product, or from the parent product for a variation without its own. A product with no SKU anywhere exports the id WooCommerce knows it by, which is still an identifier you can look up, rather than leaving a mandatory field empty. Australia Post allows 22 characters, so a longer SKU is cut to fit.
Can I send Schedule 8 or medicinal cannabis?
Not through bulk import. Australia Post rejects any bulk import declaring Yes, and those parcels need a StarTrack account instead. The setting exists so the plugin never makes a declaration on your behalf that is not true.
My store measures in grams and millimetres. Does that work?
Yes. Product dimensions and weights are converted from your store's units under WooCommerce > Settings > Products.
Where does the package height come from?
It is calculated, not guessed. See the Description above for how packing efficiency and the containing-height check work. The exported height is never below the minimum you configure.
Does it support HPOS?
Yes. The plugin declares compatibility with High-Performance Order Storage and registers its actions on both the classic and HPOS order screens.
更新日志:
- International manifests carry a SKU on every customs line. Australia Post makes it mandatory for EU member countries and rejects the row without it ("Parcel Contents - SKU is in error. Missing value for mandatory field SKU."), while the US and the rest of the world import either way. The SKU comes from the product, or its parent for a variation without one, and falls back to the product id so a mandatory field is never empty. Cut to the 22 characters Australia Post allows.
- The international template is 14 columns wider as a result, one SKU per content slot. Re-export any file you have not uploaded yet, because a file exported before this version has no SKU column in it.
- The displayed name is Bloodweb CSV Exporter for Australia Post again, matching the plugin's directory address. Settings and exports are untouched.
- After an export that includes US orders, a notice warns when the store-wide HS tariff code has fewer than the 10 digits Australia Post now requires on US-bound parcels. It shows only with the download buttons and stays away once dismissed. It is not shown when the Pro add-on is active.
- Readme: MyPost Business wording, and FAQ entries on US HS codes and EU customs descriptions.
- A new displayed name. Only the name changed: the plugin's directory address, its settings and everything it exports are untouched.
- Security: exported fields that begin with =, +, - or @ are now written as text, so a customer name, address or product title cannot run as a formula when the manifest is opened in Excel, LibreOffice or Sheets. Phone numbers are unaffected: a value made only of digits and phone punctuation is left exactly as it was so Australia Post still accepts it.
- Renamed to Bloodweb CSV Exporter for Australia Post at the WordPress.org directory's request: a plugin name needs a distinctive term of its own in front of "for Australia Post". The plugin folder changes with it, so this version installs alongside an older copy rather than over it. Deactivate and delete the old one first. Settings are untouched: they are stored under the same option names.
- Dropped the pre-3.0.0 compatibility shims: the clk_auspost_ option migration, meta key and filter aliases. Nothing runs that version any more.
- The fallback package weight is now a Minimum Package Weight: a floor under every parcel, rather than a value used only when no product in the order has a weight. Orders that weigh less than it now export the minimum, so packaging is accounted for instead of being declared away. Whatever you had saved carries over as the new minimum, and setting it to 0 keeps the summed product weights exactly as they are.
- Readme: describes the Pro add-on's tracking import accurately.
- Hooks for add-ons: per-line customs values, the parcel description, the EDN, the customs check, and actions when an export is ready and when a manifest is written.
- A link to the optional Pro add-on in the settings footer and on the Plugins screen, hidden once the add-on is installed.
- International exports now wait until the item description, HS tariff code and Export Declaration Number are set. Fresh installs no longer default to one store's jewellery customs values. Domestic exports are unaffected.
- The default domestic delivery service is now STD.
- Error messages are translatable, and the plugin passes WordPress.org's Plugin Check.
- Tested against WooCommerce 11.1.
- Added documentation, plugin page and author links to the Plugins screen and the foot of the settings screen.
- Renamed to CSV Exporter for Australia Post for the WordPress.org directory. Existing settings are kept: the internal option prefix is unchanged.
- Added the Schedule 8 / medicinal cannabis declaration to domestic manifests, so MyPost stops asking for it order by order after an import.
- Renamed the bulk action to "Export AusPost manifest".
- Tested against WordPress 7.1 and declared WooCommerce as a required plugin.
- Renamed every function, option, hook and filter to the apcsv_ prefix. Settings are migrated automatically on first load.
- Signature on delivery now also reads the order's shipping line, and any shipping method marked as signature-required.
- Orders with no shipping address fall back to the billing address as a whole, instead of exporting blank recipient columns.
- Fixed a fatal error on WooCommerce below 5.6, where get_shipping_phone() does not exist.
- Fixed an unticked signature checkbox reading as "no choice made" and falling through to the store default.
- Australia Post's reworked CN23 categories, keeping B2B and B2C sales apart. Values saved under the old list are migrated on read.
- Export a single order from its Order actions box.
- Sender details are no longer pre-filled with another business's address, and the export stops until yours are set.
- Parcel height always clears the bulkiest product in the order.
- Customs values of at least 1, and parcel weight that always covers the contents it declares.
- Volumetric package height with configurable packing efficiency.
- Whole-centimetre dimensions, fixing "Item Height is in error" on upload.
- Dimensions and weights converted from the store's own units.