Guida al connettore13 minuti di lettura38 tool MCP7 lingue

Tiendanimal MCP Server: ordini, offerte e spedizioni

Gestisci il tuo negozio sul marketplace Tiendanimal da un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore Tiendanimal.

HCA cura del team HelpCodeAggiornato 13 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Tiendanimal Marketplace

Tiendanimal Marketplace

Run your shop on the Tiendanimal marketplace from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, imports, messages, returns, invoices and transactions. The marketplace sells in Spain; sign in with the shop API key from your Tiendanimal seller back office.

tool

38

Regione

ES

Categoria

E-commerce

Autenticazione

API Key

Env vars richieste

TIENDANIMAL_API_KEY
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

Gestisci il tuo negozio sul marketplace Tiendanimal da un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore Tiendanimal.

Configurazione guidata

Collega Tiendanimal Marketplace a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Tiendanimal Marketplace con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Prova a chiedere

Prompt di esempio per Tiendanimal Marketplace

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Tiendanimal Marketplace · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Tiendanimal Marketplace, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Marketplace Tiendanimal

Gestisci il tuo negozio sul marketplace Tiendanimal da un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore Tiendanimal.

Configurazione

Paesi: Spagna. Gli ordini del marketplace vengono spediti all'interno della Spagna, escluse le Isole Canarie, Ceuta e Melilla.

Chi può vendere: Tiendanimal esamina ogni richiesta e firma un accordo con ogni venditore: contatta il suo team di vendita del marketplace. I prodotti devono essere nuovi e avere un EAN, e i prezzi includono le tasse. I venditori spediscono con il proprio corriere, accettano ogni ordine entro cinque giorni lavorativi e accettano i resi entro 14 giorni. Il connettore necessita di un account venditore che Tiendanimal ha già aperto.

L'indirizzo del venditore di questo connettore è quello che la piattaforma assegna a questo rivenditore; nessuna guida per i venditori lo nomina ancora. Se il tuo back office venditore si apre a un indirizzo diverso, faccelo sapere in chat così possiamo correggerlo.

La configurazione richiede circa 5 minuti.

  1. Accedi al back office venditore Tiendanimal: https://tiendanimal-prod.mirakl.net/login.
  2. Nel back office apri il tuo nome utente (in alto a destra) > Le mie impostazioni utente > Chiave API e clicca su Genera una nuova chiave (o copia la chiave esistente). Incollala in TIENDANIMAL_API_KEY. La chiave viene inviata così com'è nell'intestazione Authorization, senza Bearer. Generare una nuova chiave invalida la vecchia, quindi qualsiasi altro strumento che la utilizza smette di funzionare.
  3. Lascia TIENDANIMAL_SHOP_ID vuoto. Solo se il tuo utente gestisce più negozi su Tiendanimal, imposta TIENDANIMAL_SHOP_ID sull'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato sulla dashboard del back office accanto a Identificatore o ID Negozio, e restituito come shop_id da tiendanimal_get_account). Senza di esso, viene utilizzato il tuo negozio predefinito.
  4. Installa ed esegui tiendanimal_get_account: restituisce il negozio a cui appartiene la chiave.

Da dove iniziare: tiendanimal_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano usa tiendanimal_list_orders con order_state_codes=WAITING_ACCEPTANCE, tiendanimal_list_offers per prezzi e stock e tiendanimal_list_threads per messaggi che aspettano una risposta.

Prodotti e offerte concorrenti: tiendanimal_get_products cerca i prodotti nel catalogo Tiendanimal per EAN o un altro riferimento e restituisce lo SKU del prodotto del marketplace; tiendanimal_list_product_offers elenca le offerte di ogni negozio per i prodotti dati, partendo dal miglior prezzo, con circa 5 chiamate al minuto.

Flusso di lavoro degli ordini: un nuovo ordine attende in WAITING_ACCEPTANCE. tiendanimal_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi tiendanimal_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da tiendanimal_list_carriers) e tiendanimal_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa tiendanimal_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiana e has_incident=true per incidenti aperti; tiendanimal_resolve_incident chiude un incidente su una riga d'ordine una volta risolto. I documenti allegati agli ordini (bolle di consegna, etichette, fatture clienti) sono elencati da tiendanimal_list_order_documents.

Scritture: conferma prima. tiendanimal_accept_order, tiendanimal_update_tracking, tiendanimal_ship_order, tiendanimal_resolve_incident, tiendanimal_accept_return, tiendanimal_receive_return, tiendanimal_update_offers, tiendanimal_reply_thread, tiendanimal_create_order_thread e tiendanimal_import_products agiscono sul marketplace attivo. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e nuovo prezzo o stock, il testo del messaggio e i destinatari) e aspetta un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessuno strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. tiendanimal_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato spento.

Aggiornamento delle offerte (prezzi e stock): tiendanimal_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, uno sconto o descrizione mancante viene eliminato. Leggi sempre prima l'offerta (tiendanimal_get_offer o tiendanimal_list_offers con sku) e rimandala completa con solo la modifica prevista: shop_sku, product_id e product_id_type (da product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (il suo codice), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leggi come available_start_date / available_end_date) e qualsiasi offer_additional_fields. Lascia update_delete vuoto o update. La chiamata restituisce un import_id; la modifica viene applicata in modo asincrono, quindi controllala con tiendanimal_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da tiendanimal_list_offer_conditions, i codici della classe logistica da tiendanimal_list_logistic_classes.

Importazioni di file: tiendanimal_import_products (P41) e tiendanimal_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da Tiendanimal; il connettore lo scarica e lo carica su Tiendanimal. Tracciali con tiendanimal_list_product_imports / tiendanimal_get_product_import e tiendanimal_list_offer_imports / tiendanimal_get_offer_import.

Resi: tiendanimal_list_returns (RT11) elenca le richieste di reso. Dove Tiendanimal lascia decidere al negozio, tiendanimal_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e tiendanimal_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.

Messaggi: tiendanimal_list_threads elenca le conversazioni (filtra con entity_type=MMP_ORDER e entity_id=<order id> per un ordine; entity_id senza entity_type viene rifiutato), tiendanimal_get_thread legge una con i suoi messaggi, tiendanimal_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Tiendanimal) e tiendanimal_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da tiendanimal_list_reasons; lascia il suo locale vuoto a meno che tu non sappia che il marketplace ha quella lingua (un locale inattivo risponde 400).

Denaro: tiendanimal_list_invoices (IV01) elenca i documenti contabili che Tiendanimal emette al negozio e tiendanimal_list_transactions (TL02) le righe di transazione (vendite, commissioni, rimborsi, pagamenti). Se Tiendanimal utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa tiendanimal_list_document_requests (DR11) e le transazioni poi.

Intero catalogo: per leggere ogni offerta (un controllo di stock o prezzo attraverso il catalogo, contando le offerte), avvia un'esportazione con tiendanimal_export_offers, controlla tiendanimal_get_offer_export_status circa una volta al minuto fino a quando non è COMPLETED, e leggi i file uno per uno con tiendanimal_get_offer_export_file; include_fields mantiene solo le colonne di cui hai bisogno. Un'esportazione completa è consentita una volta al giorno; per ciò che è cambiato da allora, passa last_request_date (un'esportazione differenziale, al massimo una volta al minuto). Non sfogliare ogni offerta con tiendanimal_list_offers: è pensato per poche offerte alla volta e risponde 429 quando sfogliato attraverso un grande catalogo.

Più negozi: ogni strumento prende un shop_id opzionale. Un utente che gestisce più negozi su questo marketplace (un'agenzia, o un negozio per paese) può lavorare su tutti con un'unica installazione: passa l'id del negozio in ogni chiamata e controlla quale negozio è con tiendanimal_get_account e lo stesso shop_id. Senza shop_id una chiamata utilizza TIENDANIMAL_SHOP_ID, o il negozio predefinito dell'utente quando questo è vuoto. Chiedi all'utente gli id dei loro negozi; il back office li mostra.

Liste di riferimento: tiendanimal_list_channels (siti per paese), tiendanimal_list_carriers, tiendanimal_list_shipping_zones, tiendanimal_list_shipping_methods e tiendanimal_list_logistic_classes cambiano raramente; leggili una volta per conversazione.

Paginazione: ordini, offerte, fatture e importazioni di prodotti paginano con max (al massimo 100) e offset. Thread, resi, transazioni, richieste di documenti e importazioni di offerte restituiscono un next_page_token; passalo come page_token per ottenere la pagina successiva (tutti gli altri filtri vengono quindi ignorati) fino a quando non è mancante.

Date sono ISO 8601, ad esempio 2026-10-01T00:00:00Z; le risposte sono in UTC.

Limiti di frequenza: Ogni API ha il proprio limite e Tiendanimal può stringerli. L'elenco delle offerte e degli ordini è destinato a un uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, tiendanimal_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da attendere; non riprovare in un ciclo.

Errori: 401 significa che la chiave è errata o è stata sostituita da una più recente, 403 che il tuo utente non ha il diritto per questa azione, 404 che l'ordine, l'offerta o il thread non esistono per questo negozio o che il marketplace non utilizza quella funzione, come i resi, 400 un parametro errato o un ordine nello stato sbagliato (il messaggio lo nomina, ad esempio ORDER_INVALID_STATE).

Prerequisiti: TIENDANIMAL_API_KEY

Installa il connettore localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Tiendanimal Marketplace e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

StrumentoCosa fa
tiendanimal_get_accountLegge il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto…
tiendanimal_list_ordersElenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad esempio WAITING_ACCEPTANCE per…
tiendanimal_list_offersElenca le offerte del negozio (OF21): SKU, prodotto, prezzo e sconto, tutti i prezzi dei canali, quantità in stock, condizione, tempo di consegna e se…
tiendanimal_get_offerLegge un'offerta completa per il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personalizzato…
tiendanimal_list_offer_conditionsElenca le condizioni delle offerte (OF61) che il marketplace accetta, ad esempio nuovo o usato, con il codice da inserire in state_code quando si aggiornano le offerte
tiendanimal_list_offer_importsElenca le importazioni e gli aggiornamenti delle offerte (OF04), da file e da tiendanimal_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED), righe…
tiendanimal_get_offer_importLegge lo stato di un'importazione di offerta o aggiornamento offerta (OF02) per il suo import_id, come restituito da tiendanimal_update_offers o…
tiendanimal_export_offersAvvia un'esportazione di tutte le offerte del negozio come file (OF52), il modo per leggere l'intero catalogo (ogni SKU con prezzo e stock) invece di…
tiendanimal_get_offer_export_statusStato di un'esportazione di offerta avviata con tiendanimal_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code e error.detail)…
tiendanimal_get_offer_export_fileLegge un file di un'esportazione di offerta completata (OF54): le offerte con il loro SKU, prodotto, quantità, prezzi e gli altri campi esportati, come…
tiendanimal_list_product_importsElenca le importazioni di prodotti (P51) con il loro stato (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), i conteggi di trasformazione e il…
tiendanimal_get_product_importLegge lo stato di un'importazione di prodotto (P42) per il suo import_id: stato di importazione, motivo, conteggi di trasformazione e i dettagli di integrazione…
tiendanimal_get_productsCerca prodotti nel catalogo del marketplace per i loro identificatori (P31), ad esempio EAN, e ottieni lo SKU del prodotto del marketplace, titolo e categoria.…
tiendanimal_list_product_offersElenca le offerte di ogni negozio per prodotti dati (P11), ordinati per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids…
tiendanimal_list_threadsElenca i thread di messaggi (M11) con clienti e Tiendanimal: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando un…
tiendanimal_get_threadLegge un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o offerta collegata
tiendanimal_list_returnsElenca le richieste di reso (RT11) con il loro stato, righe di reso, motivo, RMA, tracciamento e l'ordine collegato. Filtra per stato, ordine o data.…
tiendanimal_list_reasonsElenca i codici di motivo del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può…
tiendanimal_list_carriersElenca i corrieri che il marketplace conosce (SH21) con il loro codice, etichetta e URL di tracciamento. Usa il codice come carrier_code in…
tiendanimal_list_invoicesElenca i documenti contabili che Tiendanimal emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza tasse…
tiendanimal_list_transactionsElenca le righe di transazione del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo…
tiendanimal_list_document_requestsElenca le richieste di documenti contabili (DR11), utilizzate quando Tiendanimal esegue la Fatturazione Venditore Avanzata: fatture e note di credito che Tiendanimal…
tiendanimal_list_order_documentsElenca i documenti allegati a uno o più ordini (OR72): bolle di consegna, etichette di spedizione, fatture clienti e altri file, con id, file…
tiendanimal_list_channelsElenca i canali di vendita del marketplace (CH11), di solito uno per sito paese, con codice ed etichetta. Usa i codici come channel_codes in…
tiendanimal_list_shipping_zonesElenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad esempio Francia continentale o Corsica. Cambiano raramente: chiamalo…
tiendanimal_list_shipping_methodsElenca i metodi di spedizione attivi del marketplace (SH12), ad esempio standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento…
tiendanimal_list_logistic_classesElenca le classi logistiche del marketplace (SH31), le fasce di dimensione o peso che decidono i prezzi di spedizione, con codice ed etichetta. Usa il codice come…
tiendanimal_accept_orderAccetta o rifiuta le righe di un ordine in attesa di accettazione (OR21). Ogni riga dell'ordine deve essere elencata. Rifiutare una riga la annulla…
tiendanimal_update_trackingImposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da tiendanimal_list_carriers, o carrier_name con carrier_url…
tiendanimal_ship_orderConferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene avvisato. Imposta prima il tracciamento con…
tiendanimal_update_offersCrea o aggiorna offerte, inclusi prezzo e stock (OF24). Sostituisce completamente ogni offerta: ogni campo lasciato fuori viene ripristinato (una mancante…
tiendanimal_reply_threadRispondi in un thread di messaggi (M12) al cliente o a Tiendanimal. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra all'utente…
tiendanimal_create_order_threadAvvia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Tiendanimal o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente il…
tiendanimal_resolve_incidentSegna l'incidente aperto su una riga d'ordine come risolto (OR64), una volta risolto il problema del cliente. reason_code deve essere un INCIDENT_CLOSE…
tiendanimal_accept_returnAccetta o rifiuta una richiesta di reso in WAITING_ACCEPTANCE (RT21). Solo quando Tiendanimal gestisce i resi nel back office venditore e lascia…
tiendanimal_receive_returnConferma che la merce di un reso accettato è arrivata nel tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace attivo…
tiendanimal_import_productsInvia un file di prodotto al marketplace (P41) per creare o arricchire i prodotti nel suo catalogo. file_url è l'indirizzo di un CSV, XLSX o XML…
tiendanimal_import_offersImporta un file di offerta (OF01) per creare, aggiornare o eliminare offerte in blocco. La modalità REPLACE elimina ogni offerta che non è nel file, e…

Esempi di richieste

  • "Quali ordini Tiendanimal stanno aspettando la mia accettazione? Tiendanimal si aspetta una risposta entro cinque giorni lavorativi."
  • "Imposta lo stock del mio cibo per gatti senza cereali 2 kg SKU TA-CAT-GF2 a 90 e mantieni il prezzo."
  • "Aggiungi il tracciamento Correos PQ4F6P0712345670128002S all'ordine 6601234-A e conferma la spedizione."
  • "Quali richieste di reso stanno aspettando la mia decisione?"
  • "Esporta il mio catalogo Tiendanimal e elenca ogni offerta che è esaurita."

Prossimi passi

Questa guida ti è stata utile?

Collega Tiendanimal Marketplace a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Tiendanimal Marketplace con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Guide correlate

Connettori

Tiendanimal MCP per ChatGPT: ordini e scorte

Gestisci il tuo negozio sul marketplace di Tiendanimal tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore di Tiendanimal.

Connettori

Tiendanimal MCP per Claude: ordini e offerte

Gestisci il tuo negozio sul marketplace di Tiendanimal tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore di Tiendanimal.

Connettori

Tiendanimal MCP per Microsoft Copilot

Gestisci il tuo negozio sul marketplace di Tiendanimal tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore di Tiendanimal.

Connettori

Tiendanimal MCP per Cursor: ordini e offerte

Gestisci il tuo negozio sul marketplace di Tiendanimal tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore di Tiendanimal.

Connettori

Tiendanimal MCP per Gemini CLI: ordini e scorte

Gestisci il tuo negozio sul marketplace di Tiendanimal tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore di Tiendanimal.

Connettori

Tiendanimal MCP per Meta Muse: ordini e scorte

Gestisci il tuo negozio sul marketplace di Tiendanimal tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Spagna; accedi con la chiave API del negozio dal tuo back office venditore di Tiendanimal.