Detecno (SAT Code) Integration — Item Mapping Configuration
Use the Detecno accordion to map your Zenoti catalog items to their SAT codes. SAT (Servicio de Administración Tributaria) is the Mexican tax authority, and each item you sell must carry the correct SAT product or service code for fiscal invoicing in Mexico.
Note: For an overview of the integrations available in Zenoti, see Integrations Overview.
On this page
- Before you begin
- Steps
- Add a SAT code mapping for an item
- Find an existing mapping
- Change or remove a mapping
- Tips
- Troubleshooting
- Related articles
Before you begin
- The Detecno integration must be enabled for your organization: in the Detecno accordion, Enable Integration must be selected and saved. The item mapping section appears only after the integration is enabled.
- SAT code mappings are configured in the Detecno accordion on the organization's Integration settings page and apply to the organization's catalog. The center-level Detecno accordion does not include item mappings.
- Have the SAT codes for your items ready, as supplied by your tax advisor or published by the Mexican tax authority.
Permission: You need organization administrator access to configure Detecno item mappings. Admin path: Configuration > Integrations > Integration settings
Steps
Add a SAT code mapping for an item
- Click the Configuration icon and navigate to Integrations > Integration settings.
- Search for and expand the Detecno accordion.
- In the item mapping section, choose the type of item you want to map: products, services, memberships, packages, or classes.
- Open the item list, which shows -- Select Item -- until an item is chosen, and select the item.
- You can type in the item list to filter it. If nothing matches what you typed, the list shows No results for '{your search term}'. Check the spelling, or confirm you chose the correct item type.
- In the field that shows the SAT Code placeholder, enter the item's SAT code. Matching SAT codes are suggested as you type; select one from the suggestions or finish typing the code.
- Zenoti checks the code against the SAT product and service code catalog. If the code is not a valid SAT code, the mapping is not added and a validation message is shown.
- Confirm the unit of measure for the item.
- Add the mapping. It appears in the mappings table below the input row.
- Repeat steps 3–7 for each item you want to map.
- Select Save to save your mappings.
Important: Mappings you add appear in the table immediately, but they are not stored until you select Save. Save before you leave the page.
Find an existing mapping
- In the Search by Item Name or Item Code field above the mappings table, enter part of an item name or a SAT code.
- The table filters as you type to show only the matching mappings.
- Clear the field to show all mappings again.
Change or remove a mapping
Each item can have only one mapping. To change an item's SAT code, remove its existing mapping from the table, add a new mapping with the correct SAT code, and then select Save.
Tips
- Work through your catalog one item type at a time — products, then services, and so on — so that no item type is missed.
- Keep your reference list of SAT codes next to your Zenoti catalog while you map items, to speed up entry and reduce errors.
- Mappings are saved for the organization, so you map each catalog item once rather than separately for every center.
Troubleshooting
| Problem | Resolution |
|---|---|
| You cannot find the item mapping section at a center | Item mappings are configured only at the organization level. Open Integration settings for the organization, not for a center. |
| The item mapping section is not shown in the Detecno accordion | Select Enable Integration, complete the integration settings, and select Save. The mapping section appears once the integration is enabled. |
| The item list shows No results for '{search term}' | No item of the selected type matches what you typed. Check the spelling, or choose a different item type. |
| An item is missing from the item list | Confirm that the item is active in your catalog and that you selected the correct item type. |
| The mapping is not added, and a validation message says the SAT code is not valid | The code is not in the SAT product and service code catalog. Check the code with your tax advisor and enter it again. |
| The mapping is not added because the item already has a mapping | Each item can have only one mapping. Remove the existing mapping from the table first, then add the new one. |
| Your mappings are gone after you reopen the page | The mappings were added to the table but not saved. Add them again and select Save. |