{"openapi":"3.1.0","info":{"title":"Consulta de Ventanilla Electrónica AFIP/ARCA","description":"API para consultar la Ventanilla Electrónica de AFIP/ARCA","version":"0.1.0"},"paths":{"/api/v1/health":{"get":{"summary":"Health Check","description":"Verifica que la API esté disponible.","operationId":"health_check_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/ve/consultar_comunicaciones/":{"post":{"summary":"Ve Consultar Comunicaciones","description":"Consulta el listado paginado de comunicaciones disponibles en Ventanilla Electrónica.","operationId":"ve_consultar_comunicaciones_api_v1_ve_consultar_comunicaciones__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VEConsultarComunicacionesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ve/consumir_comunicacion/":{"post":{"summary":"Ve Consumir Comunicacion","description":"Recupera el contenido y adjuntos de una comunicación individual.","operationId":"ve_consumir_comunicacion_api_v1_ve_consumir_comunicacion__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VEConsumirComunicacionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ve/consultar_sistemas/":{"post":{"summary":"Ve Consultar Sistemas","description":"Obtiene el catálogo de sistemas publicadores registrados en VE.","operationId":"ve_consultar_sistemas_api_v1_ve_consultar_sistemas__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VEConsultarSistemasRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ve/consultar_estados/":{"post":{"summary":"Ve Consultar Estados","description":"Recupera el catálogo de estados disponibles para las comunicaciones VE.","operationId":"ve_consultar_estados_api_v1_ve_consultar_estados__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VEConsultarEstadosRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"VEAuthRequest":{"properties":{"token":{"type":"string","title":"Token","description":"Token base64 emitido por WSAA (ver sección 2 del manual)","example":"base64token"},"sign":{"type":"string","title":"Sign","description":"Firma digital base64 emitida por WSAA","example":"base64sign"},"cuitRepresentada":{"type":"string","title":"Cuitrepresentada","description":"CUIT titular de la comunicación a consultar","example":"20269841575"},"testing":{"type":"boolean","title":"Testing","description":"Indica si la operación se ejecuta en ambiente de homologación","default":false,"example":false}},"type":"object","required":["token","sign","cuitRepresentada"],"title":"VEAuthRequest","description":"Credenciales WSAA requeridas por los métodos del servicio VE."},"VEConsultarComunicacionesFilter":{"properties":{"estado":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estado","description":"Estado de la comunicación (1=No leída, 2=Leída)","example":1},"fecha_desde":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fecha Desde","description":"Fecha límite inferior (AAAA-MM-DD)","example":"2024-01-01"},"fecha_hasta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fecha Hasta","description":"Fecha límite superior (AAAA-MM-DD)","example":"2024-12-31"},"comunicacion_id_desde":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Comunicacion Id Desde","description":"Identificador mínimo de comunicación","example":123456},"comunicacion_id_hasta":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Comunicacion Id Hasta","description":"Identificador máximo de comunicación","example":123999},"tiene_adjunto":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tiene Adjunto","description":"Filtra comunicaciones que incluyen adjuntos MTOM","example":false},"sistema_publicador_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sistema Publicador Id","description":"Identificador del sistema publicador informado por AFIP","example":19},"pagina":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pagina","description":"Número de página a recuperar (>=1)","example":1},"resultados_por_pagina":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Resultados Por Pagina","description":"Cantidad de resultados por página (1-100)","example":100},"referencia1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referencia1","description":"Primer dato de referencia definido por el organismo","example":"Aviso"},"referencia2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referencia2","description":"Segundo dato de referencia definido por el organismo","example":"Importante"}},"type":"object","title":"VEConsultarComunicacionesFilter","description":"Filtros opcionales para ``consultarComunicaciones``."},"VEConsultarComunicacionesRequest":{"properties":{"AuthRequest":{"$ref":"#/components/schemas/VEAuthRequest"},"Filter":{"anyOf":[{"$ref":"#/components/schemas/VEConsultarComunicacionesFilter"},{"type":"null"}],"description":"Conjunto de filtros opcionales definidos por AFIP"}},"type":"object","required":["AuthRequest"],"title":"VEConsultarComunicacionesRequest","description":"Payload requerido por ``consultarComunicaciones``."},"VEConsultarEstadosRequest":{"properties":{"AuthRequest":{"$ref":"#/components/schemas/VEAuthRequest"}},"type":"object","required":["AuthRequest"],"title":"VEConsultarEstadosRequest","description":"Solicitud mínima para ``consultarEstados``."},"VEConsultarSistemasRequest":{"properties":{"AuthRequest":{"$ref":"#/components/schemas/VEAuthRequest"},"idSistemaPublicador":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idsistemapublicador","description":"Identificador del sistema publicador informado por AFIP","example":8}},"type":"object","required":["AuthRequest"],"title":"VEConsultarSistemasRequest","description":"Estructura de entrada para ``consultarSistemasPublicadores``."},"VEConsumirComunicacionRequest":{"properties":{"AuthRequest":{"$ref":"#/components/schemas/VEAuthRequest"},"idComunicacion":{"type":"integer","title":"Idcomunicacion","description":"Identificador numérico de la comunicación a consumir","example":123456},"incluirAdjuntos":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Incluiradjuntos","description":"Incluye adjuntos MTOM en la respuesta cuando es True","default":false,"example":false}},"type":"object","required":["AuthRequest","idComunicacion"],"title":"VEConsumirComunicacionRequest","description":"Parámetros admitidos por ``consumirComunicacion``."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}