Factuarea APIDevelopers
Correcció

Emplena les plantilles de contactes abans d’importar

Previsualitza plantilles buides conservant les columnes i gestiona empty_import abans d’aplicar una importació.

4 d’octubre de 2026

Les plantilles de contactes conserven les capçaleres quan es previsualitzen sense files de dades. POST /v1/contacts/import/preview retorna 200 amb total=0, rows=[] i source_headers en l’ordre de l’origen; dry_run=true es comporta igual.

Descarrega la plantilla, escriu els teus contactes, puja el fitxer emplenat i revisa la correspondència de columnes abans d’aplicar-lo. El CSV descarregat fa servir UTF-8 amb BOM i comes. Si converteixes la plantilla a XLSX, conserva les capçaleres originals.

POST /v1/contacts/import rebutja un fitxer sense files de dades amb HTTP 422, business_rule_violation, subcodi empty_import i paràmetre file. No es crea un registre d’importació ni s’encua feina. Emplena la plantilla i torna-ho a provar.

Ambdues operacions continuen requerint contacts:write. MCP preview_contacts_import i import_contacts mantenen la mateixa distinció entre previsualitzar i aplicar.

Endpoints actualitzats2

EndpointDescripció
POST/v1/contacts/import/previewPrevisualitzar una importació de contactes
POST/v1/contacts/importImportar contactes