Zenda Envíos Correo Argentino for WooCommerce

Beskrivelse

Zenda connects your WooCommerce store to Correo Argentino, the Argentine postal service, so the shipping cost your customer sees is the real one. Rates are calculated at checkout against the MiCorreo API, using the destination postcode and the weight and dimensions of the cart.

No more flat rates that lose you money on long-distance orders, and no more cost tables you have to update by hand every time the carrier changes its prices.

The plugin interface is in Spanish, since Correo Argentino only ships within Argentina and the plugin is aimed at Argentine merchants.

Not affiliated with Correo Argentino

Zenda is a product of AD Webs. It is not affiliated with, sponsored by, or endorsed by Correo Argentino S.A. or Automattic Inc. “Correo Argentino”, “MiCorreo”, “Paq.Ar”, “WooCommerce” and “WordPress” are trademarks of their respective owners, used here only to describe which services this plugin integrates with. “Zenda” is our own name for the integration, not the carrier’s.

What it does

  • Real-time rates. Queries the MiCorreo API with the postcode, weight and dimensions of the order. The customer sees the exact price before paying.
  • Home delivery and branch pickup. Offer either one, or both, at different prices.
  • Branch picker at checkout. Over 2,000 Correo Argentino branches, filtered by province and searchable. The chosen branch is stored with the order.
  • Clásico and Expreso services, with the estimated delivery times reported by Correo Argentino.
  • Setup wizard that walks you through the credentials and verifies the connection before you go live.
  • Built-in diagnostics that catch the usual problems: wrong credentials, a shipping method that was never added to a zone, products with no weight set.
  • HPOS compatible (High-Performance Order Storage).

Everything above is available to everyone, with no key to enter, no account to open with us, and nothing that expires.

Which checkout you need

Zenda renders its branch picker on the WooCommerce classic checkout (the shortcode one). If your store uses the block checkout, home delivery rates are still calculated normally, but the picker is not rendered there — so the plugin hides the branch pickup option rather than offering a shipping method the customer could not complete, and tells you so in the admin.

What you need

A MiCorreo account (Correo Argentino’s service for small businesses and sole traders). It is free and you open it on the Correo Argentino website. The plugin also supports Paq.Ar accounts, for customers with a commercial agreement, with a configurable rate.

Zenda Pro

Everything Zenda does happens before the sale: quoting and choosing a branch. What comes after the sale — creating the shipment, labels, tracking, buyer notifications — is a separate paid plugin, Zenda Pro, distributed from our own site. None of its code is in this package.

External services

This plugin connects to the Correo Argentino API to quote shipments and to fetch the list of branches. It is a third-party service and it is essential for the plugin to work: without that connection there is no way to calculate a real rate.

Service: Correo Argentino API (MiCorreo and Paq.Ar)
Endpoints: https://api.correoargentino.com.ar (production) and https://apitest.correoargentino.com.ar (test environment, only if you enable sandbox mode)

What is sent, and when:

  • When quoting a shipment (when a customer reaches the cart or the checkout with an address filled in): the origin postcode configured in the plugin, the destination postcode, and the weight and dimensions of the order. The customer’s name, email, phone and full address are not sent.
  • When obtaining an access token (the first time, and whenever the token expires): a public application credential that Correo Argentino publishes for WooCommerce integrations. No data of yours or your customers’ is sent in this step.
  • When resolving your customer ID (only if you save your MiCorreo credentials without having filled in the ID): the email and password of your MiCorreo account, so that Correo Argentino returns your customer number. You can avoid this step by entering the ID by hand.
  • When syncing branches (manually from the admin, or the first time the picker is opened): your customer ID and, optionally, the province code. No customer data is sent. If you have not configured the ID, the plugin does not sync: it does not fall back to any third-party account.

Data is transmitted over HTTPS and the plugin does not store it outside your own database.

Correo Argentino terms of use: https://www.correoargentino.com.ar/terminos-de-utilizacion-de-la-pagina-web-de-correo-argentino
Correo Argentino privacy policy: https://www.correoargentino.com.ar/terminos-y-condiciones-generales-de-privacidad

This plugin sends no information to the author’s servers. There is no telemetry, no usage statistics, and no licence check.

Skærmbilleder

Installation

  1. Install and activate the plugin from Plugins > Add New.
  2. Follow the setup wizard that opens on activation, or go to Envíos Correo Argentino > Configuración.
  3. Enter your MiCorreo credentials and test the connection.
  4. Go to WooCommerce > Settings > Shipping, open the relevant zone and add Envíos Correo Argentino as a method.
  5. Choose whether you offer home delivery, branch pickup, or both.

Important: for rates to work, your products must have a weight set. The plugin’s diagnostics page tells you which ones don’t.

Compiled code

None. All the JavaScript and CSS in this plugin is distributed exactly as it was written, unminified and with no build step. There are no bundles, no minified third-party code, and no tool-generated files.

FAQ

Do I need a special Correo Argentino account?

You need a MiCorreo account, which is free and can be opened on the Correo Argentino website. It is the same account you would use to dispatch shipments from their panel.

Is anything here locked, limited or time-restricted?

No. There is no licence key, no trial period, no quota and no feature that stops working. Every screen and every option in this package works on a fresh install, indefinitely.

Why are no rates showing at checkout?

The checkout itself will tell you. When the method cannot quote, it prints the reason in place of the usual “no shipping methods available” — and if you are logged in as an administrator, it prints the exact cause with a link to the screen that fixes it.

The usual three are: your products have no weight set, the shipping method was not added to the zone that covers the destination, or the credentials are wrong. The plugin’s diagnostics page checks all three as well.

Does it work with the block checkout?

Partially, and it is worth knowing exactly how. Home delivery quotes and works just like it does in the classic checkout. Branch pickup does not: the picker that lets the customer choose a branch is rendered on the classic checkout only.

So that nobody ends up with a half-finished order, the plugin does not offer the branch option when it detects a block checkout, and it tells you in the admin. We would rather hide it than leave you with orders that have no branch assigned.

Does the plugin create the shipment in Correo Argentino?

No. It quotes and stores the chosen branch; you create the shipment yourself in the MiCorreo panel.

Can I charge a surcharge on top of the carrier’s rate?

Yes. You can add a fixed amount or a percentage on top of what Correo Argentino quotes, for example to cover packaging. You can also set free shipping above a given cart total.

Does it work for international shipping?

No. The plugin covers shipping within Argentina.

Anmeldelser

Der er ingen anmeldelser for denne widget.

Bidragsydere & udviklere

“Zenda Envíos Correo Argentino for WooCommerce” er open source-software. Følgende personer har bidraget til dette plugin.

Bidragsydere

“Zenda Envíos Correo Argentino for WooCommerce” er blevet oversat til 1 sprog. Tak til oversætterne for deres bidrag.

Oversæt “Zenda Envíos Correo Argentino for WooCommerce” til dit eget sprog.

Interesseret i udvikling?

Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.

Ændringslog

1.7.1

  • New: a percentage surcharge or discount on each shipping method. In every Correo Argentino method of a shipping zone, “Recargo o descuento (%)” raises or lowers the MiCorreo rate before the additional cost (10 adds 10 %, -10 takes 10 % off), and “Porcentaje a partir de ($)” applies it only from that cart subtotal on. Paq.Ar keeps your flat rate.

1.5.3

  • Security: the automatic MiCorreo account linking added in 1.5.1 now runs only when someone who manages the shop opens the WordPress admin. It could also be set off by any logged-in user, or by a request to admin-post.php without a session. It exposed nothing, but it made your site call MiCorreo for no reason.

1.5.1

  • Fixed: the setup wizard never linked your MiCorreo account. It saved the email and password but never asked MiCorreo for the Customer ID, which is what checkout quotes with — so a shop that finished the wizard showed no Correo Argentino rates, while the connection test said “Conexión exitosa”. Shops left in that state link themselves the next time someone opens the WordPress admin.
  • If MiCorreo rejects the email or password, the settings screen and the wizard now say so and why. Before, the screen read “Configuración guardada correctamente” and the account stayed unlinked.
  • “Probar conexión” now tests your account for real by quoting a parcel with it. It used to check only that Correo Argentino’s API answered, which passes for every shop whether or not its account is linked.
  • The Diagnóstico screen adds a test quote with your account, and its shipping zone check now asks WooCommerce which zone each province falls into. It warns when a province lands in a zone without the method, and when the method sits in a zone no address ever reaches — WooCommerce only uses the first matching zone in the list.
  • The Diagnóstico screen names missing sender fields the way the settings screen does (“Dirección”, “Provincia”) instead of by their internal keys.

1.5.0

  • The admin menu icon is now the Zenda mark instead of a generic envelope. The envelope drew the carrier, not us, and it was the last thing in the plugin still wearing the old identity.
  • Fixed: the logo on the plugin’s screens was requested at a fixed URL, and browsers cache it for a year — so a new logo would not have reached anyone who had already opened those screens. The URL now carries the version number.

1.4.1

  • Fixed 27 spelling mistakes in the built-in help centre: questions that opened without the “¿”, “Si” where the affirmative “Sí” was meant, “esta” for “está”, and a fistful of missing accents — tamaño, dimensión, integración, producción, documentación, selección, límites, aún, creó, válido. The plugin’s interface is written in Argentine Spanish rather than translated into it, so these were mistakes in the original text: every merchant reading the help centre saw them, whatever language pack they had installed.

1.4.0

  • The plugin now carries the Zenda logo, and every link to the paid edition points at its new name and home: Zenda Pro, at zendaenvios.com. Nothing the plugin does changed.
  • Added the Update URI header, so WordPress only ever offers updates for this plugin from wordpress.org.

1.3.0

  • Renamed to Zenda Envíos Correo Argentino for WooCommerce, with a matching prefix (zenda_) on every option, hook, AJAX action and asset handle.
  • The branch selector’s CSS and JavaScript, the help centre’s stylesheet and the admin notices’ dismissal script are now registered and enqueued instead of being printed inline.
  • The admin notice about the block checkout now explains the limitation and what to do about it, without pointing anywhere else.

1.2.1

  • Fixed: the explanation added in 1.2.0 never appeared in the block checkout — the one WooCommerce installs by default. It hooked the two filters the classic checkout templates apply, and the block checkout renders that message from its own JavaScript and never calls them. It now also goes out through the Store API, the same channel the branch validation already used. It is only emitted when no shipping method quoted at all: if the store offers local pickup or a flat rate as well, a notice there would block a checkout that could still be completed.

1.2.0

  • Fixed: the plugin asked for its translations too early when registering its scheduled tasks, which WordPress 6.7 and later logs as a notice. Nothing was broken and it was only visible with debugging on, but it filled the log and pointed at us.
  • New: when Correo Argentino does not show up at checkout, it now says why instead of just disappearing. Shoppers are told what they can act on — the postcode is still empty, the cart is over the weight limit — and store administrators get the exact cause with a link to the screen that fixes it. The explanation survives a page reload, which matters because WooCommerce caches calculated rates and does not recalculate on every view.

1.1.4

  • New: if the Correo Argentino API does not respond, the checkout shows the last known rate instead of leaving the customer with no shipping options at all. The fallback rate is only served for 72 hours; after that it fails on purpose, because a genuinely old rate would have you undercharging. Every time it is used it is recorded in WooCommerce > Status > Logs.
  • Rate lookups at checkout now wait 8 seconds instead of 15. With a healthy API the answer comes back in under a second, so the only thing that changes is how long it takes to give up.
  • Fixed: an expired token with the API down would sink a quote that was already cached. The cache is now checked before authenticating.

1.1.3

  • First submission to WordPress.org.
  • Real-time rates for home delivery and branch pickup via MiCorreo.
  • Branch picker with search and province filter, in the classic checkout.
  • Setup wizard and built-in diagnostics.