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

# Document Accounted

> Se envía cuando un documento es causado (registrado contablemente) en Payana. El payload incluye `reference`, `fiscal_reference`, `fiscal_metadata` (p. ej. `final_notes` del XML) y `accounting_entry` con el detalle de la causación.

**`accounting_entry`:** siempre incluye `reference` y `accounted_at` del registro en Payana. Según la empresa y el motor de causación, el objeto se amplía con:

- **Asiento ERP (V2):** `registration_payload`, `summary`, `journal_entry` (líneas del asiento y `payment_lines`) y `advance_crossings`.
- **Legacy:** campos como `causation_state`, `products`, `payments`, etc.

Si no hay detalle adicional disponible, solo verás `reference` y `accounted_at`. Es `null` cuando el documento aún no fue causado.

El receptor debe responder con `200` para confirmar la recepción.

Antes de procesar el evento, verifica la firma HMAC del request. Consulta [Signature Verification](/api-reference/introduction#signature-verification) en la introducción de la API.


## OpenAPI

````yaml WEBHOOK document.accounted
openapi: 3.1.0
info:
  title: Payana Accounts Payable API
  description: >-
    API pública para gestionar cuentas por pagar (payments) y beneficiarios
    (beneficiaries) en Payana, incluyendo notificaciones por webhooks cuando se
    procesan pagos.
  version: 1.0.0
servers:
  - url: https://api.prod.payana.cloud/public/api/v1
    description: Production
  - url: https://api.develop.payana.cloud/public/api/v1
    description: Develop
security:
  - apiKeyAuth: []
tags:
  - name: Payments
    description: Crear y listar pagos
  - name: Beneficiaries
    description: Crear, listar y consultar beneficiarios
  - name: Webhooks
    description: Eventos de webhooks enviados por Payana
  - name: Banks
    description: Listar y consultar bancos
  - name: Transactions In
    description: Transacciones entrantes (polling, mismo formato que webhooks)
  - name: Documents
    description: Listar, consultar y operar documentos (cuentas por pagar)
  - name: DIAN Events
    description: >-
      Encolar eventos DIAN (030 Acuse de recibo, 031 Reclamo, 032 Recibo del
      bien, 033 Aceptación expresa, 034 Aceptación tácita) para documentos
      identificados por CUFE. El procesamiento es asíncrono.
  - name: Fiscal Sync
    description: >-
      Disparar y consultar sincronización de documentos fiscales desde el SAT
      (México) o la DIAN (Colombia).
  - name: Workflow Steps
    description: >-
      Resolver el paso en que está parado un documento dentro de su flujo:
      aprobación, clasificación o etiquetado.
paths: {}
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: API key provista por Payana.

````