ImportaTic

0Projectes

0Actius

0Sync en curs

Projectes

+ Nou projecte

Buscar projecte

Mostrant 0 projectes.

Encara no hi ha projectes. Crea'n un amb el botó "Nou projecte".

Projecte

Projecte no trobat.

Nou projecte

1) Dades bàsiques Nom del projecte

És només el nom intern per identificar aquest projecte dins l'app. No canvia res a Woo ni a Catalog.

Exemple: Si poses "Botiga Girona", només canvia com el veus tu a la llista.

Descripció

Camp opcional. Serveix per deixar una nota teva i recordar per a què és aquest projecte.

Exemple: Si poses "Només vins", és una nota interna; no s'envia enlloc.

Interval cron (minuts)

Cada quants minuts es farà una sync automàtica. Si el projecte està inactiu, no farà res automàtic.

Exemple: 30 = cada 30 minuts. 120 = cada 2 hores.

Timeout peticions (ms)

Temps màxim d'espera per cada crida a API. Si passa aquest temps, aquella crida es talla.

Exemple: 30000 = 30 segons. Si no ho tens clar, deixa 30000.

Projecte actiu

Si activat: El connector executa sincronitzacions automàtiques amb l'interval configurat.

Si desactivat: No hi ha execució automàtica; només quan prems "Sync ara".

Exemple si activat: Interval 30 min: el projecte sincronitza sol cada 30 minuts.

Exemple si desactivat: Pots tenir-lo aturat mentre fas proves i llançar sync manual quan vulguis.

Gestionar estoc

Si activat: S'envien canvis d'estoc a Woo (stock_quantity i stock_status).

Si desactivat: No es toca l'estoc de Woo; només s'actualitzen la resta de camps.

Exemple si activat: Si a Catalog passa de 8 a 3 unitats, Woo també passarà a 3.

Exemple si desactivat: Si a Catalog passa de 8 a 3, Woo es quedarà amb el valor anterior.

2) Connexions Domini API origen

És el domini base del teu Catalog Player. Amb domini + SSID + hash, el connector ja construeix les rutes automàticament.

Exemple: https://api.clientcatalog.com (només domini, sense /api/v1/... )

SSID API

Una de les dues claus d'accés de Catalog Player. Es fa servir junt amb el hash.

Exemple: Exemple real de format: cca5d72b...

Hash API

La segona clau d'accés de Catalog Player. Sense aquesta clau, la connexió normalment falla.

Exemple: Exemple real de format: fe1b416d...

Tarifa per IVA (PricelistToken)

Indica quina tarifa de Catalog vols consultar per obtenir preus/IVA. Si no feu tarifes, ho pots deixar buit.

Exemple: Si poses 2, llegirà preus/IVA de la tarifa 2.

Catàleg token (value)

Identifica quin catàleg concret has de llegir dins Catalog Player.

Exemple: CP1 (si no saps quin és, sol ser CP1 per defecte)

Idioma origen

Idioma en què es llegeixen els textos del catàleg (nom, descripció, etc.).

Exemple: es, ca o en (segons el que tingui el teu Catalog)

Amb domini + ssid + hash es construeixen automàticament: API origen, API estoc i API IVA/preus. URL origen resolta: — · URL estoc: — · URL IVA/preus: —

Quan hi ha domini + ssid + hash, el camp de mapatge "Quantitat d'estoc" s'oculta automàticament.

Configuració avançada API origen (JSON, opcional)

Això només és per casos especials (canviar rutes/claus internes). Si no t'ho han demanat, deixa-ho buit.

Exemple: Exemple: {"rutes":{"productes":"/api/v1/product/get"}}

Si ho deixes buit, s'apliquen rutes i claus estàndard del connector.

Ruta de l'array de productes (opcional)

Només cal si l'API retorna els productes "amagats" dins d'un objecte. En la majoria de casos, va buit.

Exemple: Si la resposta és {"data":{"items":[...]}} has de posar: data.items

Capçaleres JSON (opcional)

Són "dades extra" que viatgen a cada petició API. Només toca aquest camp si el proveïdor t'ha dit exactament què posar.

Exemple: Si et diuen "posa un Bearer token", escriu: {"Authorization":"Bearer EL_MEU_TOKEN"}. Si no, deixa-ho buit.

URL base WooCommerce

La URL principal de la botiga Woo on s'han de crear/actualitzar productes.

Exemple: https://botiga.exemple.com

Consumer key (deixa buit per mantenir)

Usuari tècnic de Woo (part pública de la clau API).

Exemple: Comença per ck_...

Consumer secret (deixa buit per mantenir)

Contrasenya privada de la clau API de Woo.

Exemple: Comença per cs_...

No hi ha clau guardada encara. Canvis en claus queden guardats quan prems "Desar projecte".

Sense prova encara.

3) Mapatge visual

Mapatge manual + auto-suggerit

Introdueix rutes manualment o prem analitzar perquè et proposi camps reals detectats.

Encara no hi ha anàlisi. Pots mapejar manualment igualment.

Mapatge configurat: 0/20 camps.

Mapatges extres CP → Woo (equivalent al BLOC C)

Molt simple: a l'esquerra poses la ruta de Catalog, a la dreta el camp Woo. Exemple: ProductPrice → regular_price.

Atributs extres (Color, Talla, Marca...)

Marca "valor múltiple" només quan el camp porti diversos valors separats per coma. Exemple: "Negre, Blau". Si és decimal com "0,75", deixa-ho desmarcat.

Cap atribut extra. Prem "+" per afegir-ne un.

Identificador extern (ID) Camp únic per identificar el producte. Pots posar el mateix que el SKU (imprescindible)

Mostra: —

SKU (Referència) Codi únic del producte (Recomanat). (imprescindible)

Mostra: —

Nom del producte Títol principal a la botiga.

Mostra: —

Slug (URL amigable) Part final de la URL (opcional).

Mostra: —

Descripció llarga Text principal de la fitxa.

Mostra: —

Descripció curta Text al costat del preu.

Mostra: —

Imatge principal URL de la foto.

Mostra: —

Preu regular Preu base sense oferta.

Mostra: —

Preu d'oferta Preu rebaixat (opcional).

Mostra: —

Quantitat d'estoc Unitats disponibles.

Mostra: —

Etiquetes (Tags) Paraules clau separades per comes.

Mostra: —

Pes (kg) Necessari per calcular enviaments.

Mostra: —

Llargada (cm) Dimensions.

Mostra: —

Amplada (cm) Dimensions.

Mostra: —

Alçada (cm) Dimensions.

Mostra: —

Classe d'impost Codi d'impost (ex: "reduced-rate").

Mostra: —

Estat de l'impost Opciós: taxable, shipping, none.

Mostra: —

Classe d'enviament Slug de la classe d'enviament.

Mostra: —

Producte destacat? Si conté "true" o "1", serà destacat.

Mostra: —

Nota de compra Nota enviada al client després de pagar.

Mostra: —

Els camps buits intenten auto-detecció en temps d'importació.

Configuració avançada

Opcions addicionals

Mode auth Woo

És la manera com ens identifiquem davant Woo. Normalment has de deixar "auto".

Exemple: Cas real: poses "auto", guardes, i el connector ja usa el mètode que funcioni a la teva web.

Estat publicació

Decideix en quin estat quedaran els productes de forma general.

Exemple: Cas real: amb "draft" entren ocults; amb "publish" surten visibles directament.

Si desapareix de l'origen

Quina acció fem a Woo quan Catalog ja no retorna aquell producte.

Exemple: Cas real: tries "esgotat" i el producte segueix a Woo però amb stock 0.

Idioma principal atributs

Idioma que prioritzem per llegir valors d'atributs automàtics.

Exemple: Cas real: poses "ca" i "Color" intentarà agafar-se en català si existeix.

Cas real ràpid: En una botiga normal, deixa Mode auth = auto, Estat = publish i Si desapareix = esgotat. És la combinació més segura per començar.

Atributs exclosos (AttributeToken_X, separats per coma)

Aquí poses atributs que no vols enviar a Woo.

Exemple: Cas real: "TextoCaja,PublicarInternet" fa que aquests dos atributs no apareguin al producte Woo.

Categories Woo (ids separats per coma, opcional)

IDs de categories que s'afegiran sempre a tots els productes sincronitzats.

Exemple: Cas real: "12,18" vol dir que cada producte acabarà també dins aquestes 2 categories.

Filtre de productes (JSON)

Permet decidir quines files de l'origen entren a la sync.

Exemple: Cas real: només importar productes amb Active=1 i Publicarinternet=SI.

Cas real: Si vols evitar soroll, exclou atributs interns (com PublicarInternet) i fixa una categoria de control (ex. 99 "Importats").

BLOC A · Comportament de publicació

Decideix com entren els productes nous la primera vegada.

Exemple: Cas real: producte nou entra en pending perquè el revisis abans que es vegi a la web.

Nous productes en estat pending (només quan es creen)

Si activat: Els productes nous es creen com a "pending" perquè els puguis revisar abans de publicar.

Si desactivat: Els productes nous es creen amb l'estat general que tinguis al camp "Estat publicació".

Exemple si activat: Coca-Cola nova entra a Woo com pending i la revises manualment.

Exemple si desactivat: Coca-Cola nova entra directament com publish (o draft/private segons configuració).

Exemple curt: Actiu = ON: "Coca-Cola Zero" nova entra com pending. Actiu = OFF: entra amb l'estat general (ex. publish).

BLOC B · Forçar camps Woo (JSON)

Permet fixar valors de Woo que sempre han de guanyar.

Exemple: Cas real: vols sempre "catalog_visibility=visible" encara que l'origen digui una altra cosa.

Camps forçats (s'apliquen sempre)

JSON on cada clau és un camp de Woo i cada valor és el valor fix.

Exemple: Cas real: {"catalog_visibility":"visible","featured":false}

Exemple curt: Si poses {"catalog_visibility":"visible"}, tots els productes quedaran visibles al catàleg Woo sempre.

BLOC C · Mapatge estàndard CP → Woo (JSON)

Serveix per dir quin camp de Catalog omple quin camp estàndard de Woo.

Exemple: Cas real: ProductPrice de Catalog va a regular_price de Woo.

Mapatge lliure de camps

JSON amb format: "rutaCatalog":"campWoo".

Exemple: Cas real: {"ProductPrice":"regular_price","ProductWeight":"weight"}

Exemple curt: Si mapejes ProductWeight → weight, quan a Catalog hi ha "0.75", a Woo es desa el pes "0.75".

BLOC D · Metadata custom (JSON)

Desa informació extra de Catalog dins meta_data de Woo (no visible directament al client).

Exemple: Cas real: guardar marca, família o anyada en camps tècnics _cp_...

Mapatge meta_key → ruta origen

JSON on esquerra és la clau meta de Woo i dreta la ruta de Catalog.

Exemple: Cas real: {"_cp_family":"FamilyName","_cp_year":"Vintage"}

Exemple curt: Si poses {"_cp_brand":"BrandName"} i el valor és "Codorníu", es guardarà _cp_brand=Codorníu al producte Woo.

BLOC E · Fitxers com metadata (JSON)

Llegeix URLs de fitxers (PDF, manuals...) i les desa a meta_data.

Exemple: Cas real: guardar la URL de la fitxa tècnica al meta _cp_fitxa_pdf.

Mapatge meta_key → ruta de fitxers

JSON on esquerra és la clau meta Woo i dreta és on trobar el fitxer a Catalog.

Exemple: Cas real: {"_cp_manual":"FichaTecnica"}

Sobreescriure metadata si la clau ja existeix

Si activat: Si la clau ja existeix, se n'actualitza el valor amb el nou valor del catàleg.

Si desactivat: Si la clau ja existeix, es conserva el valor existent i no se sobreescriu.

Exemple si activat: _cp_brand passa de "MarcaAntiga" a "MarcaNova".

Exemple si desactivat: _cp_brand es queda en "MarcaAntiga" encara que arribi "MarcaNova".

Exemple curt: Si actives "Sobreescriure metadata", el PDF nou substituirà l'antic. Si no, es conservarà el que ja hi havia.

BLOC F · Límit de nom d'atributs

Retalla noms d'atribut molt llargs per evitar problemes a Woo.

Exemple: Cas real: "Anyada de collita molt llarga..." es retalla al límit que indiquis.

Limitar llargada del nom dels atributs

Si activat: El nom dels atributs es retalla al màxim de caràcters que indiquis.

Si desactivat: Es manté el nom original complet, encara que sigui molt llarg.

Exemple si activat: Màxim 28: "Anyada de collita especial llarga" queda retallat.

Exemple si desactivat: Sense límit: es guarda "Anyada de collita especial llarga" complet.

Màxim caràcters

Nombre màxim de lletres del nom d'atribut quan el límit està activat.

Exemple: 28 = màxim 28 caràcters

Exemple curt: Amb límit 28, "Color especial temporada premium 2026" passarà a un nom més curt i estable a Woo.

Gestió d'imatges d'origen

Decideix com s'envien les imatges a Woo. Aquest valor també es pot tocar des del fitxer backend del projecte.

Exemple: Normal = envia imatges amb reintents. Fallback = si Woo rebutja imatge, prova sense imatge. Off = no envia imatges.

Etiquetes: separar per comes

Si activat: Divideix el camp d'etiquetes per comes i crea una etiqueta per cada valor.

Si desactivat: No divideix per comes; tot el text es guarda com una sola etiqueta.

Exemple si activat: "Eco, Promo, Estiu" crea 3 etiquetes diferents.

Exemple si desactivat: "Eco, Promo, Estiu" crea una sola etiqueta amb aquest text complet.

Exemple curt: Amb "Etiquetes múltiples" activat, "Eco, Novetat, Outlet" crea 3 etiquetes. Si està desactivat, crea una única etiqueta amb tot el text.

Zona de perill (desplega per veure accions sensibles)

Accions crítiques

Si has esborrat manualment els productes a Woo, prem aquí perquè el connector "oblidi" els enllaços antics i els torni a crear.

Si has canviat mapatge o condicions d'atributs, prem aquí per forçar una actualització global sense perdre l'enllaç amb Woo.

Si falten atributs a Woo, prem aquí per forçar la re-sincronització d'atributs a tots els productes (sense tocar la resta de camps).

Sincronització incremental: si canvia qualsevol dada o el mapatge/configuració, s'actualitza automàticament a Woo.