> ## 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.

# Obtener los datos de facturación

> Devuelve los datos de facturación de la cuenta. Requiere el scope billing:read.

Un pedido necesita datos de facturación completos. Comprueba `complete` antes de crear uno.

### Respuesta

`response` es `null` hasta que se guardan los datos de facturación. La respuesta nunca se guarda en caché.

**response** `object | null`

**Mostrar objeto**

**name** `string | null`

El nombre que aparece en los recibos y las facturas.

**address** `object | null`

**Mostrar objeto**

**line1** `string`

Nombre de la calle.

**number** `string | null`

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

**line2** `string | null`

Complemento, por ejemplo `Apt 2`.

**district** `string | null`

Barrio (bairro).

**city** `string`

Ciudad.

**city\_code** `string | null`

Código de municipio IBGE de siete dígitos.

**state** `string | null`

Código de estado de dos letras en Brasil.

**postal\_code** `string | null`

Código postal (CEP en Brasil).

**country** `string`

Código de país ISO de dos letras.

**phone** `string | null`

Número de teléfono opcional, en formato E.164.

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

**Mostrar objeto**

**type** `string`

`cpf` o `cnpj`.

**masked** `string`

El documento, enmascarado. El número completo nunca se devuelve.

**complete** `boolean`

`true` cuando los datos son suficientes para crear un pedido (en Brasil, incluido el CPF/CNPJ).

```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 fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`403`).
* `USER_NOT_FOUND`: No se encontró el usuario autenticado.
* `INTERNAL_SERVER_ERROR`: Se produjo un error inesperado en el servidor.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```


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