Raó social i nom comercial d'una empresa
name és el nom amb què es coneix una empresa i business_name la seva raó social quan és diferent. Les respostes segueixen aquest contracte a totes les empreses, l'edició parcial es resol sobre els noms actuals i tots dos camps admeten fins a 100 caràcters.
2 de novembre de 2026 — Una empresa té una raó social i, si vol, un nom comercial. L'API d'empreses els publica en dos camps i ara els dona el mateix significat a totes les empreses, s'hagin donat d'alta per on s'hagin donat. La forma del JSON no canvia i no es retira cap operació.
| Camp | Significat |
|---|---|
name | El nom amb què es coneix l'empresa: el seu nom comercial o, quan business_name és null, la seva raó social. |
business_name | La seva raó social quan és diferent de name. null quan name és la raó social. |
Operacions d'aquesta publicació
| Operació | operationId | Tool MCP | Què canvia |
|---|---|---|---|
POST /v1/accounts/{account}/companies | public-api.v1.companies.create | create_company | name és el nom amb què es coneix l'empresa i business_name la seva raó social quan és diferent. Tots dos admeten fins a 100 caràcters. |
PATCH /v1/accounts/{account}/companies/{company} | public-api.v1.companies.update | update_company | Es resol sobre els noms actuals, mira l'edició parcial. name admet fins a 100 caràcters. |
GET /v1/accounts/{account}/companies/{company} | public-api.v1.companies.show | get_company | Retorna els dos noms amb aquest significat a totes les empreses. |
GET /v1/accounts/{account}/companies | public-api.v1.companies.list | list_companies | Igual, a cada NIF del llistat. |
POST /v1/accounts/{account}/companies/{company}/activate | public-api.v1.companies.activate | activate_company | Igual, a l'empresa que retorna. |
POST /v1/accounts/{account}/companies/activate | public-api.v1.companies.activate_batch | activate_companies | Igual, a cada empresa que retorna. |
POST /v1/accounts/{account}/companies/{company}/deactivate | public-api.v1.companies.deactivate | deactivate_company | Igual, a l'empresa que retorna. |
POST /v1/accounts | public-api.v1.managed_accounts.create | provision_managed_account | display_name és el nom comercial del NIF nou i admet fins a 100 caràcters, igual que legal_name. |
Edició parcial
PATCH es resol sobre els noms actuals:
- Canviar només
namecanvia el nom comercial si l'empresa té una raó social diferent i, si no, la raó social. - Canviar només
business_namecanvia la raó social i conservaname. "business_name": ""fa denamela raó social.
Què més canvia
- Empreses donades d'alta a l'aplicació web. Una empresa donada d'alta a l'aplicació web amb nom comercial retornava els dos noms al revés. Ara els retorna com qualsevol altra.
- Longitud. Un
name,business_nameodisplay_namemés llarg respon422amb l'error del camp abans d'escriure res. Abans tampoc no es podia desar. - Declaracions. El que identifica l'empresa davant l'AEAT (models 303, 130 i 347, Facturae i UBL) fa servir sempre la raó social.