Razón social y nombre comercial de una empresa
name es el nombre con que se conoce a una empresa y business_name su razón social cuando es distinta. Las respuestas siguen ese contrato en todas las empresas, la edición parcial se resuelve sobre los nombres actuales y los dos campos admiten hasta 100 caracteres.
2 de noviembre de 2026 — Una empresa tiene una razón social y, si quiere, un nombre comercial. La API de empresas los publica en dos campos y ahora les da el mismo significado en todas las empresas, se hayan dado de alta por donde se hayan dado. La forma del JSON no cambia y no se retira ninguna operación.
| Campo | Significado |
|---|---|
name | El nombre con que se conoce a la empresa: su nombre comercial o, cuando business_name es null, su razón social. |
business_name | Su razón social cuando es distinta de name. null cuando name es la razón social. |
Operaciones de esta publicación
| Operación | operationId | Tool MCP | Qué cambia |
|---|---|---|---|
POST /v1/accounts/{account}/companies | public-api.v1.companies.create | create_company | name es el nombre con que se conoce a la empresa y business_name su razón social cuando es distinta. Los dos admiten hasta 100 caracteres. |
PATCH /v1/accounts/{account}/companies/{company} | public-api.v1.companies.update | update_company | Se resuelve sobre los nombres actuales, mira la edición parcial. name admite hasta 100 caracteres. |
GET /v1/accounts/{account}/companies/{company} | public-api.v1.companies.show | get_company | Devuelve los dos nombres con ese significado en todas las empresas. |
GET /v1/accounts/{account}/companies | public-api.v1.companies.list | list_companies | Igual, en cada NIF del listado. |
POST /v1/accounts/{account}/companies/{company}/activate | public-api.v1.companies.activate | activate_company | Igual, en la empresa que devuelve. |
POST /v1/accounts/{account}/companies/activate | public-api.v1.companies.activate_batch | activate_companies | Igual, en cada empresa que devuelve. |
POST /v1/accounts/{account}/companies/{company}/deactivate | public-api.v1.companies.deactivate | deactivate_company | Igual, en la empresa que devuelve. |
POST /v1/accounts | public-api.v1.managed_accounts.create | provision_managed_account | display_name es el nombre comercial del NIF nuevo y admite hasta 100 caracteres, igual que legal_name. |
Edición parcial
PATCH se resuelve sobre los nombres actuales:
- Cambiar solo
namecambia el nombre comercial si la empresa tiene una razón social distinta y, si no, la razón social. - Cambiar solo
business_namecambia la razón social y conservaname. "business_name": ""hace denamela razón social.
Qué más cambia
- Empresas dadas de alta en la aplicación web. Una empresa dada de alta en la aplicación web con nombre comercial devolvía los dos nombres al revés. Ahora los devuelve como cualquier otra.
- Longitud. Un
name,business_nameodisplay_namemás largo responde422con el error del campo antes de escribir nada. Antes tampoco se podía guardar. - Declaraciones. Lo que identifica a la empresa ante la AEAT (modelos 303, 130 y 347, Facturae y UBL) usa siempre la razón social.