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

# Actualizar los datos de facturación

> Reemplaza los datos de facturación de la cuenta. Requiere el ámbito billing:write.

Los datos de facturación se usan en los recibos y en las facturas, y un pedido necesita que estén completos. La petición
reemplaza los datos guardados. Incluye datos personales (nombre, dirección y CPF/CNPJ), así que envía solo valores que
haya facilitado el titular de la cuenta.

**name** `string` *required*

El nombre que aparece en los recibos y en las facturas.

**address** `object` *required*

**Mostrar objeto**

**line1** `string` *required*

Nombre de la calle.

**number** `string`

Número de la calle, o `S/N`. Obligatorio en Brasil.

**line2** `string`

Complemento, por ejemplo `Apt 2`.

**district** `string`

Barrio (bairro). Obligatorio en Brasil.

**city** `string` *required*

Ciudad.

**city\_code** `string`

Código de ciudad del IBGE de siete dígitos. Obligatorio en Brasil.

**state** `string`

Código de estado de dos letras en Brasil, por ejemplo `CE`. Obligatorio en Brasil.

**postal\_code** `string`

Código postal. En Brasil, es obligatorio el CEP de 8 dígitos.

**country** `string` *required*

Código de país ISO de dos letras, por ejemplo `BR`.

**phone** `string | null`

Número de teléfono opcional, en formato E.164, por ejemplo `+5585999990000`. `null` o omitirlo elimina el teléfono
guardado.

**tax\_id** `object | null`

El CPF o el CNPJ. Obligatorio en Brasil para que los datos estén completos. `null` elimina el documento guardado;
omitir el campo lo mantiene.

**Mostrar objeto**

**type** `string` *required*

`cpf` o `cnpj`.

**value** `string` *required*

El número del documento.

Fuera de Brasil, bastan `line1`, `city` y `postal_code`.

### Respuesta

Los datos guardados, con el documento enmascarado, y `complete`. Consulta
[Obtener los datos de facturación](https://docs.vertracloud.app/es-es/api-reference/endpoint/billing/get-billing-details.md) para ver los campos. La
respuesta nunca se almacena en caché.

```json Response theme={null}
{
  "response": {
    "name": "Ana Souza",
    "address": {
      "line1": "Rua das Flores",
      "number": "120",
      "line2": null,
      "district": "Centro",
      "city": "Fortaleza",
      "city_code": "2304400",
      "state": "CE",
      "postal_code": "60000000",
      "country": "BR"
    },
    "phone": "+5585999990000",
    "tax_id": { "type": "cpf", "masked": "CPF ••• 47" },
    "complete": true
  }
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP que no está en su lista de permitidas, o no tiene el ámbito que requiere la ruta (`403`).
* `USER_NOT_FOUND`: No se encontró el usuario autenticado.
* `BILLING_DETAILS_INVALID`: Un campo no superó la validación; su nombre está en `details.path` (`400`).
* `TAX_ID_INVALID`: El CPF o el CNPJ no es válido (`400`).
* `PAYMENT_METHOD_UNAVAILABLE`: El pago en línea no está disponible temporalmente (`400`).
* `INTERNAL_SERVER_ERROR`: Se produjo un error inesperado en el servidor.

```json Error Response (400) theme={null}
{
  "code": "BILLING_DETAILS_INVALID",
  "details": { "path": "address.postal_code" }
}
```


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