{"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/keys/":{"post":{"tags":["llaves y certificados"],"summary":"Create Private Key","description":"Genera una llave privada RSA de 2048 bits y la devuelve en base64.","operationId":"create_private_key_api_v1_keys__post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/csr/":{"post":{"tags":["llaves y certificados"],"summary":"Create Csr","description":"Genera una solicitud de certificado (CSR) a partir de una llave privada.","operationId":"create_csr_api_v1_csr__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestCSR"}}},"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/token_sign/":{"post":{"tags":["llaves y certificados"],"summary":"Obtener Token Sign","description":"Obtiene el LoginTicketResponse de WSAA, con token y sign codificados.","operationId":"obtener_token_sign_api_v1_token_sign__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenSignRequest"}}},"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_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"},"RequestCSR":{"properties":{"private_key":{"type":"string","title":"Private Key","description":"Clave privada en formato PEM codificada en base64"},"cuit_representado":{"type":"string","title":"Cuit Representado","description":"CUIT del representado","example":"20374730429"},"cn":{"type":"string","title":"Cn","description":"Nombre común (CN) del certificado","example":"mrbot"}},"type":"object","required":["private_key","cuit_representado","cn"],"title":"RequestCSR","description":"Datos necesarios para generar una solicitud de certificado (CSR)."},"TokenSignRequest":{"properties":{"cuit_representante":{"type":"string","title":"Cuit Representante","description":"CUIT del representante en ARCA/AFIP","example":"20374730429"},"certificado":{"type":"string","title":"Certificado","description":"Certificado PEM codificado en base64"},"llave_privada":{"type":"string","title":"Llave Privada","description":"Llave privada PEM codificada en base64"},"servicio_id":{"type":"string","title":"Servicio Id","description":"ID del servicio WSAA","example":"wsfe"},"testing":{"anyOf":[{"type":"boolean"},{"type":"string"}],"title":"Testing","description":"Usa homologación si es True","default":false},"cn":{"type":"string","title":"Cn","description":"Common name del certificado","default":"mrbot"}},"type":"object","required":["cuit_representante","certificado","llave_privada","servicio_id"],"title":"TokenSignRequest","description":"Datos criptográficos para obtener un token y sign de WSAA."},"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"}}}}