Saltar al contenido principal
POST

Crear una cuenta contable

Scope:accounting:chart-of-accounts.write
https://api.holded.com/api/v2/accounting-accounts

Crea una nueva cuenta contable en tu plan de cuentas. Las cuentas contables categorizan las transacciones financieras para los informes y se ajustan al plan contable de tu país. La respuesta devuelve el `id` de la nueva cuenta.

Cuerpo de la petición

object
prefixintegerrequired

Código de grupo del plan contable (1-4 dígitos). El número de cuenta completo se asigna automáticamente dentro de este grupo cuando no se indica `number`

numberinteger | nulloptional

Número de cuenta exacto a asignar (ej. 70000013). Si se proporciona, se usa tal cual y debe ser único

namestringrequired

Nombre para mostrar de la cuenta contable

descriptionstring | nulloptional

Descripción opcional del propósito de la cuenta

colorstring | nulloptional

Código de color hexadecimal para la interfaz

Petición

python
import requests

url = "https://api.holded.com/api/v2/accounting-accounts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "prefix": 0,
    "number": 0,
    "name": "string",
    "description": "string",
    "color": "string"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Respuestas

Respuesta

json
{
  "id": "507f1f77bcf86cd799439011"
}

Respuestas exitosas

201Cuenta contable creadaapplication/json
object
idstring

Respuestas de error

400Solicitud incorrectaapplication/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
422Error de validaciónapplication/json
429Límite de solicitudes excedidoapplication/json