> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amovio.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrare mobile.de

> Conectează contul Seller API mobile.de, publică mașini din inventar, alege varianta corectă de model și gestionează anunțurile.

## Prezentare generală

Integrarea **mobile.de** îți permite să publici mașini din Amovio pe mobile.de, prin **Seller API**, fără să reintroduci datele manual. Publici din fișa mașinii, sincronizezi modificările, retragi anunțul când mașina se vinde și vezi starea anunțului în blocul de platforme al mașinii.

## Conectarea contului

<Note>
  Accesul la Seller API se activează manual de către mobile.de. Scrie la [service@team.mobile.de](mailto:service@team.mobile.de) ca să ceri activarea, apoi folosește în Amovio credențialele primite.
</Note>

1. Mergi la **Setări → Integrări → mobile.de** și apasă **Adaugă Conexiune**.
2. Completează:
   * **Nume Cont**: o etichetă după care recunoști conexiunea în Amovio (de exemplu „Cont Principal mobile.de”);
   * **Nume utilizator API** și **Parolă API**: credențialele Seller API;
   * **Număr client mobile.de**: numărul de dealer alocat contului tău.
   * Opțional, bifează **Mediu de test (sandbox)** dacă vrei să testezi fără anunțuri reale.
3. Apasă **Testează Conexiunea**. Amovio verifică datele direct la mobile.de și afișează sellerii găsiți.
4. În **Configurare Finală** completează **Persoană Contact**, **Telefon Contact** și **Email Contact**, care apar pe anunțuri. Alege apoi **Vizibilitate cont**: privat, doar pentru tine, sau partajat cu echipa.
5. Apasă **Finalizează Configurarea**.

<Tip>
  Poți conecta mai multe conturi mobile.de, de exemplu câte unul pentru fiecare locație. La publicare alegi contul din dialog.
</Tip>

### Gestionarea conexiunilor

Fiecare conexiune apare într-un card cu statusul, numărul de **Anunțuri Active** și **Total Publicate**. Din card poți:

* **Verifică Conexiunea**: retestează credențialele;
* deschide setările (**Setări Conexiune mobile.de**): nume, date de contact, vizibilitate, **Nr. maxim imagini** (între 1 și 40, implicit 20) și mediul de test;
* **Schimbă credențialele**: actualizezi numele de utilizator și parola API fără să recreezi conexiunea, apoi apeși **Salvează credențialele**;
* șterge conexiunea. Anunțurile deja publicate nu sunt șterse de pe mobile.de.

## Pregătirea mașinii

Înainte să trimită anunțul, Amovio verifică mașina. Dacă lipsește ceva, publicarea se oprește și dialogul îți spune exact ce trebuie completat, în loc de eroarea generică *„Invalid request data”* de la mobile.de.

| Verificare | Mesaj dacă lipsește |
| - | - |
| Statusul mașinii nu e **Ciornă** | *Mașinile cu status Ciornă (draft) nu pot fi publicate pe mobile.de…* |
| Marca și modelul | *Marca (make) lipsește* / *Modelul (model) lipsește* |
| Modelul există în nomenclatorul mobile.de | *Modelul „…” nu este recunoscut de mobile.de pentru marca …* |
| Prețul | *Prețul lipsește sau este invalid* |
| Kilometrajul | *Kilometrajul (km) lipsește sau este invalid* |
| Anul de fabricație sau data primei înmatriculări | *Anul de fabricație sau data primei înmatriculări lipsește* |
| **Tipul de caroserie** | *Tipul de caroserie lipsește — completează tipul de caroserie al mașinii înainte de publicarea pe mobile.de* |

### Tip caroserie (obligatoriu)

mobile.de cere o categorie pentru fiecare autoturism, iar Amovio o deduce din **tipul de caroserie** al mașinii. Dacă îl lași gol, publicarea e blocată. Completează caroseria în formularul mașinii, salvează și reîncearcă.

| Caroseria în Amovio (exemple) | Categoria pe mobile.de |
| - | - |
| sedan, limuzină, saloon | Limousine |
| combi, break, wagon, touring | EstateCar |
| SUV, crossover, 4x4 | OffRoad |
| cabrio, decapotabilă, roadster | Cabrio |
| compact, mini, city-car, Sportback | SmallCar |
| coupe, sport, fastback | SportsCar |
| minivan, monovolum, MPV | Van |
| pick-up sau valori nerecunoscute | OtherCar |

O valoare neobișnuită nu blochează publicarea: mașina ajunge în **OtherCar**. Ca anunțul să apară în categoria corectă, folosește totuși una dintre valorile de mai sus.

### Prețul

Pe mobile.de prețul apare întotdeauna în **EUR**. Prețurile în RON sunt convertite automat la cursul EUR aplicat de Amovio. Prețurile în EUR sunt trimise neschimbate (rotunjite).

### Descrierea în engleză

Pe mobile.de se folosește, în ordine:

1. **descrierea în engleză** a mașinii, dacă există;
2. descrierea în română;
3. un text generat din datele mașinii, dacă ambele lipsesc.

Varianta în engleză o creezi din fișa mașinii, cu **Descriere**. În tabul **English**, apasă **Traduce cu AI**, verifică textul și salvează. Dacă schimbi ulterior descrierea în română, traducerea **nu** se actualizează singură: apasă **Re-traduce** sau corectează manual textul în engleză înainte să sincronizezi anunțul.

<Note>
  Formatarea HTML nu ajunge pe mobile.de, iar textele mai lungi de 10.000 de caractere sunt scurtate.
</Note>

### Titlu și daune

* Titlul anunțului e generat din model, an și kilometraj (de exemplu `Seria 3 2022 49k km`). mobile.de adaugă singur marca în față.
* Câmpul **daune nereparate** cerut de mobile.de se completează din fișa mașinii. Dacă nu ai marcat mașina ca având daune nereparate, se trimite „nu”. Declară corect starea mașinii, pentru că cumpărătorii se bazează pe această informație.

## Publicarea unui anunț

1. Deschide mașina din **Inventar** și alege **Publică pe mobile.de** din acțiunile mașinii sau din rândul **mobile.de** al blocului de platforme.
2. Alege **Conexiune mobile.de**.
3. Dacă e nevoie, alege varianta de model (vezi mai jos).
4. Apasă **Publică pe mobile.de**.

După publicare, anunțul apare direct ca **Activ**, iar pe fișa mașinii apare linkul către anunțul live. Pe site-ul mobile.de anunțul poate deveni vizibil abia după câteva minute.

<Note>
  Dacă anunțul se creează, dar încărcarea pozelor eșuează, vezi un avertisment separat. Anunțul rămâne publicat, iar pozele le poți retrimite cu **Sincronizează**.
</Note>

### Alegerea variantei de model

Nomenclatorul mobile.de nu folosește mereu aceleași denumiri de model ca inventarul tău. La deschiderea dialogului, Amovio compară modelul mașinii cu lista mobile.de pentru marca respectivă:

| Situație | Ce vezi în dialog |
| - | - |
| Modelul există identic (de exemplu `Urus`) | Niciun selector. Publici direct |
| Modelul din Amovio e o familie, iar mobile.de are doar variante (de exemplu `GLC` → `GLC 200`, `GLC 300`) | Selectorul **Variantă mobile.de pentru GLC**, cu prima variantă preselectată |
| Modelul din Amovio e mai lung decât denumirea mobile.de (de exemplu `AMG GT 4-door Coupe` → `AMG GT`) | Selectorul cu cea mai specifică denumire potrivită preselectată |
| Nicio potrivire | Selectorul cu toate modelele mobile.de pentru marca respectivă |

<Warning>
  Verifică varianta preselectată înainte de publicare, mai ales la Mercedes-Benz și BMW, care au multe motorizări. Varianta aleasă e reținută pentru sincronizările ulterioare. Numele complet al modelului rămâne în descrierea anunțului.
</Warning>

## Stări și acțiuni

| Status | Ce înseamnă | Acțiuni |
| - | - | - |
| **Nepublicat** | Mașina nu are anunț pe mobile.de | **Publică pe mobile.de** |
| **Activ** | Anunțul e live | **Sincronizează**, **Retrage** |
| **Eroare** | Ultima publicare a eșuat; mesajul apare în dialog | Corectează datele și **Republică pe mobile.de** |
| **Șters** | Anunțul a fost retras | **Republică pe mobile.de** |
| **Lipsă** | În Amovio apare publicat, dar anunțul nu mai există pe mobile.de | **Republică pe mobile.de** sau **Șterge legătura** |

* **Sincronizează** trimite datele curente ale mașinii (preț, descriere, specificații, poze) către anunțul existent.
* **Retrage** șterge anunțul de pe mobile.de și închide legătura din Amovio. Pentru aceeași mașină poți publica ulterior un anunț nou.
* **Șterge legătura** curăță doar înregistrarea din Amovio, când anunțul nu mai există pe mobile.de.

<Note>
  Modificările făcute în inventar ajung pe mobile.de când apeși **Sincronizează** pe anunț. Dacă un anunț publicat recent nu e încă vizibil la mobile.de, sincronizarea răspunde *„mobile.de încă propagă anunțul publicat recent”*. Reîncearcă peste câteva minute.
</Note>

### Retragerea la vânzare

Când schimbi statusul mașinii din **meniul de status** (de pe cardul din **Inventar** sau din fișa mașinii) în **Vândut**, **Ciornă** sau **Arhivat**, anunțul mobile.de activ este retras automat.

<Warning>
  Retragerea funcționează într-un singur sens: dacă ștergi anunțul direct pe mobile.de, mașina **nu** este marcată ca vândută în Amovio. Actualizează statusul din inventar.
</Warning>

## Depanare

<AccordionGroup>
  <Accordion title="Tipul de caroserie lipsește">
    Editează mașina, completează **tipul de caroserie**, salvează și reîncearcă **Publică pe mobile.de**.
  </Accordion>

  <Accordion title="Modelul nu este recunoscut de mobile.de">
    Deschide din nou dialogul de publicare și alege varianta corectă din selectorul de model. Dacă selectorul nu apare, verifică denumirea mărcii și a modelului în fișa mașinii.
  </Accordion>

  <Accordion title="Eroare pe un câmp după trimitere">
    Dacă mobile.de respinge o valoare, dialogul arată câmpul și valoarea refuzată (de exemplu `gearbox: valoare invalidă "XYZ"`). Corectează câmpul în fișa mașinii și reîncearcă.
  </Accordion>

  <Accordion title="Anunțul apare în categoria greșită">
    Categoria vine din tipul de caroserie. Corectează caroseria, salvează și apasă **Sincronizează**.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.