EntregaFlow Contract Shipping with Correios for WooCommerce

EntregaFlow quotes Correios SEDEX and PAC in the WooCommerce cart with the credentials of your own Correios contract (CWS API). A cart with several products is quoted as one package: the weights and declared values are added up and one box holds the total volume.

In Settings > EntregaFlow, the “Check with Correios” tool shows the exact figures sent for a parcel you type in (weight, size, declared value, postcodes, contract and DR) and the price Correios returned, so you can type the same figures into your contract’s simulator and find where a difference comes from.

The Correios product code of the chosen service (03220 for SEDEX, 03298 for PAC, or your contract’s own codes) is stored on the order under the meta key _entregaflow_product_code, for ERP and label tools.

Every screen and message is ready for translation; the Brazilian Portuguese translation is being added through translate.wordpress.org.

Something not right? If a quote does not appear, or differs from your contract’s price, open a support ticket at https://github.com/brisolo/support/issues with the “Check with Correios” table (never include your access code), and we will help you sort it out.

Not in this version: labels, tracking, declaration of content, pre-posting.

Features

• SEDEX and PAC quotes with your own contract credentials. Product codes are settings: 03220 and 03298 by default, or your contract’s codes (for example 04162 and 04669).
• Optional declared value (additional service 019 for SEDEX, 064 for PAC). The cart total is sent as the declared value; if Correios refuses it (for example above a service’s maximum), that service is quoted without declared value and the refusal is logged.
• One consolidated package per cart, plus the packaging weight and extra centimetres you set.
• “Check with Correios” breakdown, including the charged weight and the additional services returned by Correios.
• Clear messages for shop managers (never for customers), an admin notice while a setup error (credentials, product codes, products without weight) stops quotes, and a log of every failed quote in WooCommerce > Status > Logs.
• Compatible with WooCommerce order storage (HPOS) and the block cart and checkout.

Prices and responsibility

The prices shown are the ones the Correios API returns for the data sent at the moment of the quote. EntregaFlow does not guarantee that Correios charges the same amount at posting: weighing, packaging, additional services and your contract’s table are set by Correios. Check the quotes against your contract’s simulator before relying on them in your shop. The plugin is provided “as is”, without warranty, under the terms of the GPL.

Trademarks

EntregaFlow is not affiliated with or endorsed by Correios. “Correios”, “SEDEX” and “PAC” are trademarks of Empresa Brasileira de Correios e Telégrafos; the plugin uses them only to name the carrier and the services it quotes through the official API with your own contract. WooCommerce is a trademark of Automattic; EntregaFlow is independent.

External service: Correios API

The plugin connects to one external service, the Correios API at api.correios.com.br, with your own contract credentials. To authenticate, it sends your Meu Correios user, API access code and postage card number. For each quote, it sends the origin and destination postcodes, the weight and dimensions of the package, the declared value (only when you turn that on) and, if set, your contract number and DR. Nothing is sent anywhere else, and the plugin’s author receives no data at all. The credentials are stored in your site’s options table, unencrypted like other WooCommerce settings, and are removed when the plugin is deleted.

• Correios API documentation and access rules (CWS): https://www.correios.com.br/atendimento/developers
• Correios privacy policy (Política de Privacidade e Cookies): https://www.correios.com.br/falecomoscorreios/politica-de-privacidade-e-cookies
• EntregaFlow privacy policy: https://github.com/brisolo/support/blob/main/privacy/entregaflow.md

Support

Support is answered on GitHub issues, in Portuguese or English, and the forum here is checked weekly: https://github.com/brisolo/support/issues

Help articles in Portuguese: https://github.com/brisolo/support/tree/main/docs/entregaflow