Webhooks

El cliente tendrá que indicar a Swipoo un endpoint donde lanzar los evento vía una llamada HTTPS [POST].

Cambio de estado del trámite

Tipos de trámite: TRANSACTION, REGISTRATION, BATE

Estados posibles:

  • PENDING_DOCUMENTATION
  • QUEUED_TO_PROCESS
  • IN_PROCESS
  • PRESENTED_TO_DGT
  • APPROVED_BY_DGT
  • DOCS_AT_OFFICE
  • DOCS_SENT
  • DOCS_DELIVERED
  • CANCELLED
{
  "event": "STATUS_CHANGE",
  "data": {
    "id": "8d3fdfc6-fc35-4d52-b346-922f37763bd6",
    "procedure_type": "BATE",
    "code": "H423FSA3",
    "new_status": "APPROVED_BY_DGT",
    "old_status": "PRESENTED_TO_DGT"
  }
}

Nuevo comentario en el trámite

{
  "event": "NEW_COMMENT",
  "data": {
    "id": "3efcef53-04eb-4a21-be98-bb518f5d4c62",
    "procedure_type": "TRANSACTION",
    "code": "4U3CLHU2",
    "author": "[email protected]",
    "comment": "Dado que es una intermediación, procedemos a cobramos el ITP para liquidar en nombre del comprador."
  }
}

Incidencia abierta en el trámite

Tipos de incidencia:

  • wrong_counterparties
  • domain_reservation
  • not_tramitable
  • itp_not_paid
  • incorrect_fiscal_census
  • invalid_documentation
  • ivtm_pending
  • missing_documentation
  • seizure
  • delivery_incident
{
  "event": "INCIDENT_OPEN",
  "data": {
    "id": "f5523f7b-1f1a-482b-b78f-3114c97f34c3",
    "procedure_type": "TRANSACTION",
    "code": "P0HXTUAK",
    "incident_type": "invalid_documentation",
    "description": "La dirección en la factura no es la misma que la del DNI del comprador, hay que adjuntar padrón o corregir la dirección en la factura."
  }
}

Incidencia cerrada en el trámite

{
  "event": "INCIDENT_CLOSE",
  "data": {
    "id": "f5523f7b-1f1a-482b-b78f-3114c97f34c3",
    "procedure_type": "TRANSACTION",
    "code": "P0HXTUAK"
  }
}

Nuevo documento disponible en el trámite

  • Solicitud de baja: TEMPORARY_LEAVE_REQUEST
  • Permiso de circulación provisional de gestoría: TEMPORARY_CIRCULATION_PERMIT
  • Permiso de circulación provisional de DGT: PRESENTATION_PROOF
  • Justificante de pago del ITP: PAID_ITP_FILE
  • Contrato firmado: SIGNED_CONTRACT
  • Mandato de gestoría firmado: MANDATE_SIGNED
{
  "event": "NEW_FILE_AVAILABLE",
  "data": {
    "id": "f5523f7b-1f1a-482b-b78f-3114c97f34c3",
    "doc_type": "TEMPORARILY_CIRCULATION_PERMIT",
    "procedure_type": "TRANSACTION",
    "code": "P0HXTUAK",
    "uri": "https://swipoo-transactions-files.s3.eu-west-1.amazonaws.com/C5716BSS%20PROVI-hash-ffae8e45-5ad8-4877-a929-bebc05b8d1dc.pdf?AWSAccessKeyId=XXXXXXXXX&Expires=1739882947&Signature=XXXXXXXXXXX"
  }
}