Pricing Demo Docs

Set up your store

Prepare your issuer, signing credentials, products and customers before processing orders.

Loading video…

Watch video and read transcript: Set up your store

Steps at a glance

1. Start with the issuer

Save the issuer’s cédula in Configs. Review the company record returned for that identification.

2. Match Hacienda’s records

Check issuer location against the tax registry, including all three location levels. Save Company Data.

3. Save the signing setup

Save the correct Hacienda credentials, PIN and certificate. Keep production and sandbox credentials separate.

4. CABYS: variant, product, then collection

Use hacienda.structured_cabys in Shopify. Priority: variant → product → collection. Leave higher levels blank to inherit. The customer still needs hacienda.structured_cedula for domestic FE or ticosync.tax_id for export identity; check HS codes for export goods.

5. Set a collection default in Shopify

Shopify → Products → Collections → select collection → Metafields → Hacienda Cabys Code → Save. TicoSync creates/pins the collection definition when the embedded app opens. If absent, reopen TicoSync and reload Shopify. Use one agreed collection code, or an explicit product/variant override if collection defaults conflict. Allow up to five minutes for lookup caches.

6. Check channels, then enable processing

Review channel activity mappings and optional B2B tags. Confirm Process Orders is On; verify the actual Hacienda result after fulfillment.

Check the issuer’s Hacienda status

Below the saved cédula, Configs shows Overdue tax payments and Missing tax returns from Hacienda and the last successful check. The status refreshes hourly. If Hacienda is unavailable, the page marks the failed refresh and keeps the last known result; an unavailable value is not NO.

Use NITE and passport identification

In The Well POS, select NITE for a ten-digit NITE number or Passport for a passport. In Shopify, use hacienda.structured_cedula for NITE and set hacienda.identification_type to 04; passports use ticosync.tax_id and type 05. NITE supports regular FE invoices. Ordinary local passport sales receive a TE with the passport; actual exports follow the FEE flow. Passport alone does not make a sale an export.

The issuer/signing portion is the original masked staging recording. CABYS diagrams explain the current Shopify metafield configuration and precedence; the final settings screen is from the same staging recording. No production customer data or fiscal submission is used.

Browse all video guides

Chat on WhatsApp