Pour exporter hors UE ou remplir vos documents douaniers, chaque produit doit disposer d’un code HS (Harmonized System) et d’un pays d’origine. PrestaShop ne propose pas nativement ces champs de façon structurée pour l’ensemble du catalogue.
Ce module ajoute une table dédiée et des outils d’import pour renseigner ces données produit par produit, y compris sur les déclinaisons.
Depuis la configuration du module, importez un fichier CSV au format :
référence;code_hs;pays_origine
Le module expose des méthodes statiques réutilisables dans vos overrides, modules ou templates PDF :
AmHscodes::getHscode($idProduct, $idProductAttribute)AmHscodes::getOrigin($idProduct, $idProductAttribute)AmHscodes::getHscodeAndOrigin($idProduct, $idProductAttribute)Idéal pour afficher code HS et pays d’origine sur les factures, bons de livraison ou exports logistiques.
Des modèles de facture et bon de livraison personnalisables sont documentés dans le dossier pdf/ du module (à copier dans votre thème). Affichez les informations douanières directement sur vos documents commerciaux.
ps_amhscodes créée à l’installation,Ce module codes HS pour PrestaShop centralise vos données douanières, accélère la mise à jour catalogue via CSV et s’intègre à vos flux documentaires. Indispensable pour sécuriser vos expéditions internationales.
Livraison immédiate du ZIP après achat, avec licence et mises à jour selon la durée choisie.
""" YOAST_TITLE = "Module PrestaShop codes HS et pays d'origine - Douane export" YOAST_METADESC = ( "Module PrestaShop pour gérer codes HS et pays d'origine produits. Import CSV par référence, " "API PHP, templates facture/livraison. Compatible PS 1.7 à 8." ) YOAST_FOCUS = "Module PrestaShop codes HS" VARIATIONS = [ ("6 mois", "49.97"), ("12 mois (25% d'économie)", "87.4475"), ("24 mois (54% d'économie)", "97.9412"), ] IMAGE_FILES = [ ("product-amhscodes-featured.png", "Module PrestaShop codes HS et pays d'origine produits", True), ("product-amhscodes-admin.png", "Back-office PrestaShop - import CSV codes HS et pays d'origine", False), ("product-amhscodes-import.png", "Interface d'import en masse des codes douaniers HS", False), ("product-amhscodes-module.png", "Module PrestaShop amhscodes - logo", False), ] DOWNLOAD_NAME = "module-codes-hs-pays-origine-prestashop-1.0.0" def post_json(base_url: str, user: str, password: str, path: str, payload: dict) -> dict: url = f"{base_url.rstrip('/')}{path}" _, data = _request( "POST", url, user, password, data=json.dumps(payload).encode("utf-8"), headers={"Content-Type": "application/json"}, ) return data def put_json(base_url: str, user: str, password: str, path: str, payload: dict) -> dict: url = f"{base_url.rstrip('/')}{path}" _, data = _request( "PUT", url, user, password, data=json.dumps(payload).encode("utf-8"), headers={"Content-Type": "application/json"}, ) return data def main() -> None: cfg = load_config() base = cfg.wp_base_url user = cfg.wp_user pwd = cfg.wp_application_password.replace(" ", "") print("Upload des images…") image_ids: list[int] = [] featured_id: int | None = None for filename, alt, is_featured in IMAGE_FILES: path = ASSETS / filename media = upload_media(base, user, pwd, path, alt_text=alt, title=alt) mid = int(media["id"]) image_ids.append(mid) if is_featured: featured_id = mid print(f" media {mid}: {filename}") print("Upload du ZIP…") zip_media = upload_media( base, user, pwd, ZIP_PATH, alt_text="Module PrestaShop codes HS v1.0.0", title=DOWNLOAD_NAME, ) zip_url = zip_media.get("source_url") or zip_media.get("guid", {}).get("rendered", "") print(f" zip URL: {zip_url}") print("Création du produit variable (brouillon)…") product_payload = { "name": PRODUCT_NAME, "slug": SLUG, "type": "variable", "status": "draft", "catalog_visibility": "visible", "description": DESCRIPTION_HTML, "short_description": SHORT_DESCRIPTION, "sku": SKU, "virtual": True, "downloadable": True, "downloads": [ { "id": str(uuid.uuid4()), "name": DOWNLOAD_NAME, "file": zip_url, } ], "download_limit": -1, "download_expiry": -1, "tax_status": "taxable", "manage_stock": False, "categories": [{"id": 714}], "tags": [ {"name": "prestashop"}, {"name": "module prestashop"}, {"name": "codes HS"}, {"name": "douane"}, {"name": "export"}, {"name": "logistique"}, ], "images": [{"id": i} for i in image_ids], "attributes": [ { "id": 2, "position": 0, "visible": True, "variation": True, "options": [v[0] for v in VARIATIONS], }, { "id": 3, "position": 1, "visible": False, "variation": False, "options": ["Conversions"], }, ], "default_attributes": [ {"id": 2, "name": "Durée du SAV et des mises à jour", "option": "6 mois"}, ], "meta_data": [ {"key": "_yoast_wpseo_title", "value": YOAST_TITLE}, {"key": "_yoast_wpseo_metadesc", "value": YOAST_METADESC}, {"key": "_yoast_wpseo_focuskw", "value": YOAST_FOCUS}, {"key": "_yoast_wpseo_primary_product_cat", "value": "714"}, {"key": "_amlicence_lm_enabled", "value": "yes"}, {"key": "_amlicence_lm_activation_slots", "value": "1"}, {"key": "_amlicence_lm_expiry_months", "value": "0"}, ], } product = post_json(base, user, pwd, "/wp-json/wc/v3/products", product_payload) product_id = int(product["id"]) print(f"Produit créé: id={product_id}") print("Création des variations…") for option, price in VARIATIONS: var_payload = { "regular_price": price, "virtual": True, "downloadable": True, "downloads": product_payload["downloads"], "attributes": [ { "id": 2, "name": "Durée du SAV et des mises à jour", "option": option, } ], "meta_data": [ {"key": "_amlicence_lm_enabled", "value": "yes"}, {"key": "_amlicence_lm_activation_slots", "value": "1"}, {"key": "_amlicence_lm_expiry_months", "value": "0"}, ], } var = post_json( base, user, pwd, f"/wp-json/wc/v3/products/{product_id}/variations", var_payload, ) print(f" variation {var['id']}: {option} → {price} €") print("Mise à jour ACF (meta WooCommerce) et image à la une…") changelog = ( "