Recursos

Cuenta y créditos

Antes de un batch grande, conviene chequear que tiene créditos suficientes y mirar la config efectiva del seller.

Info de la cuenta

GET/v2/account

scopeaccount:read

RequestGET /account

curl "https://api.automeli.com/api/v2/account" \
     -H "X-API-Key: automeli_live_..."

200Response

Cuenta, créditos y configuración de publicación efectiva del seller.

{
  "seller_id": 108386,
  "email": "cuenta@ejemplo.com",
  "ml_nickname": "MITIENDA",
  "ml_site_id": "MCO",
  "amazon_site": "amazon.com",
  "ml_currency": "COP",
  "ml_account_status": "active",
  "ml_connected": true,
  "api_key": {
    "id": 12,
    "name": "ERP Producción",
    "environment": "live",
    "tier": "default"
  },
  "credits": {
    "total": 5000,
    "available": 1240,
    "used_live": 3760,
    "used_test": 85
  },
  "publishing_config": {
    "trm": 4100,
    "warranty_time": "30 días",
    "manufacturing_time_days": 12,
    "stock_quantity": 5
  }
}

credits.available se calcula según el entorno de la key que usó: con una key live descuenta used_live; con una key test, used_test. Los dos contadores se devuelven siempre para que sepa contra qué pool va a publicar. Antes de publicar también puede verificar ml_connected: true.

Errores posibles de este endpoint (2)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404

Categorías fiscales del seller

Devuelve las categorías fiscales que el seller tiene configuradas en Configuración → Impuestos. El id es exactamente el valor numérico que se pasa como automeli_tax_category en POST /v2/products.

Hoy las categorías sólo se pueden editar desde el dashboard (no borrar), así que en la práctica el índice se mantiene estable. Aun así, conviene cachear esta lista periódicamente en lugar de hardcodear ids.

GET/v2/account/tax-categories

Probar en sandbox

scopeaccount:read

RequestGET /account/tax-categories

curl "https://api.automeli.com/api/v2/account/tax-categories" \
     -H "X-API-Key: automeli_live_..."

200Response

Array de categorías fiscales tal cual están en la config del seller.

{
  "seller_id": 108386,
  "tax_categories": [
    {
      "id": 0,
      "name": "IVA 19%",
      "taxes": {
        "iva": 19,
        "impuesto2": 0,
        "impuesto3": 0,
        "iva_v2": 19,
        "impuesto2_v2": 0,
        "impuesto3_v2": 0
      }
    }
  ]
}

Devuelve el array tal cual está en la config del seller, sin filtrar entradas viejas o marcadas "para dejar de usar" — así queda consistente con lo que ve y edita en el dashboard. Los campos iva/impuesto2/impuesto3 son el tab legacy "Configuración descontinuada"; los _v2 son la nueva configuración. Si la cuenta no tiene categorías cargadas, la lista viene vacía y sólo se acepta automeli_tax_category: 0 al publicar.

Errores posibles de este endpoint (2)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404