{
  "openapi": "3.1.1",
  "info": {
    "title": "Ecuafact API",
    "description": "API publica de facturacion electronica del SRI (Ecuador): emision y consulta de comprobantes, catastro del SRI y webhooks firmados. Requiere la cabecera X-Api-Key. La version del contrato viaja en la cabecera X-Api-Version. Cabecera opcional X-Additional-Info: texto del integrador (ASCII imprimible, maximo 256) que la API registra en sus logs para soporte.",
    "contact": {
      "name": "Ecuafact",
      "url": "https://docs.mynexusapi.com/v1/guias/agentes"
    },
    "license": {
      "name": "Uso comercial",
      "identifier": "LicenseRef-Ecuafact-Uso-Comercial"
    },
    "version": "2026-11-16"
  },
  "servers": [
    {
      "url": "https://api-sandbox.mynexusapi.com/"
    }
  ],
  "paths": {
    "/salud": {
      "get": {
        "tags": [
          "Salud"
        ],
        "summary": "Comprueba que el servicio responde",
        "description": "Devuelve el estado basico del servicio. No requiere API Key.",
        "operationId": "obtenerSalud",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "head": {
        "tags": [
          "EcuafactSRIApi.Api"
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/estado": {
      "get": {
        "tags": [
          "Salud"
        ],
        "summary": "Consulta el estado del servicio",
        "description": "Devuelve el estado publico del servicio: el estado general, el estado de cada componente, la disponibilidad de los ultimos 90 dias, los incidentes de ese periodo y el momento de la ultima medicion. No requiere API Key.",
        "operationId": "obtenerEstadoServicio",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "head": {
        "tags": [
          "EcuafactSRIApi.Api"
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/catalogos": {
      "get": {
        "tags": [
          "Catalogos"
        ],
        "summary": "Lista los catalogos del SRI.",
        "description": "Devuelve la clave de cada catalogo y una descripcion breve. Usa la clave en\r\n`GET /v1/catalogos/{nombre}` para leer el detalle. Los catalogos cambian pocas veces al anio:\r\nla respuesta se puede guardar en cache por una hora.",
        "operationId": "listarCatalogos",
        "responses": {
          "200": {
            "description": "Catalogos disponibles.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogosDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/catalogos/{nombre}": {
      "get": {
        "tags": [
          "Catalogos"
        ],
        "summary": "Obtiene el detalle de un catalogo del SRI.",
        "description": "Devuelve las filas del catalogo con su codigo, descripcion y, segun el catalogo, el valor (por ejemplo\r\nla tarifa en porcentaje), la vigencia y atributos propios. La respuesta se puede guardar en cache por\r\nuna hora.",
        "operationId": "obtenerCatalogo",
        "parameters": [
          {
            "name": "nombre",
            "in": "path",
            "description": "Clave del catalogo, tal como la devuelve `GET /v1/catalogos`.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "tarifas-iva"
          }
        ],
        "responses": {
          "200": {
            "description": "Detalle del catalogo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogoDetalleDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contexto": {
      "get": {
        "tags": [
          "Contexto"
        ],
        "summary": "Obtiene el contexto de la integracion.",
        "description": "Devuelve los contribuyentes habilitados para la API Key y sus tipos de comprobante.\r\nEs la primera llamada recomendada para obtener la identificacion de las rutas.",
        "operationId": "obtenerContexto",
        "responses": {
          "200": {
            "description": "Contribuyentes y capacidades de la credencial.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContextoDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/consultas/contribuyentes/{identificacion}": {
      "get": {
        "tags": [
          "Consultas SRI"
        ],
        "summary": "Consulta un contribuyente en el catastro del SRI.",
        "description": "No consume cupo. La fuente permite elegir el padrón y fusionar sus datos.",
        "operationId": "consultarContribuyente",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "RUC o cedula a consultar.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0123456789001"
          },
          {
            "name": "fusionar",
            "in": "query",
            "description": "Combina la informacion disponible de las fuentes consultadas.",
            "schema": {
              "type": "boolean",
              "default": true
            },
            "example": true
          },
          {
            "name": "fuente",
            "in": "query",
            "description": "Fuente del catastro; Todas por defecto.",
            "schema": {
              "type": "string",
              "default": "Todas"
            },
            "example": "Todas"
          }
        ],
        "responses": {
          "200": {
            "description": "Datos del contribuyente.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContribuyenteConsultaDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/consultas/contribuyentes": {
      "get": {
        "tags": [
          "Consultas SRI"
        ],
        "summary": "Busca contribuyentes en el catastro del SRI.",
        "description": "No consume cupo. Devuelve una lista acotada por max.",
        "operationId": "buscarContribuyentes",
        "parameters": [
          {
            "name": "apellidos",
            "in": "query",
            "description": "Apellidos o razon social a buscar; es obligatorio.",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "example": "PEREZ LOPEZ"
          },
          {
            "name": "nombres",
            "in": "query",
            "description": "Nombres del contribuyente.",
            "schema": {
              "type": "string",
              "default": ""
            },
            "example": "JUAN"
          },
          {
            "name": "clase",
            "in": "query",
            "description": "Clase o tipo de contribuyente.",
            "schema": {
              "type": "string",
              "default": ""
            },
            "example": "PersonaNatural"
          },
          {
            "name": "max",
            "in": "query",
            "description": "Cantidad maxima de resultados.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 10
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "Coincidencias encontradas.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BusquedaContribuyenteDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/consultas/establecimientos/{ruc}": {
      "get": {
        "tags": [
          "Consultas SRI"
        ],
        "summary": "Lista los establecimientos de un RUC en el catastro.",
        "description": "No consume cupo.",
        "operationId": "listarEstablecimientos",
        "parameters": [
          {
            "name": "ruc",
            "in": "path",
            "description": "RUC de 13 digitos.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1790012345001"
          },
          {
            "name": "filtro",
            "in": "query",
            "description": "Filtro de estado o tipo de establecimiento.",
            "schema": {
              "type": "string",
              "default": "Todos"
            },
            "example": "Todos"
          }
        ],
        "responses": {
          "200": {
            "description": "Establecimientos encontrados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EstablecimientosConsultaDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/consultas/identificacion/validar/{numero}": {
      "get": {
        "tags": [
          "Consultas SRI"
        ],
        "summary": "Valida una cedula, RUC o pasaporte.",
        "description": "Comprueba formato y digito verificador. No consume cupo.",
        "operationId": "validarIdentificacion",
        "parameters": [
          {
            "name": "numero",
            "in": "path",
            "description": "Identificacion a validar.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "responses": {
          "200": {
            "description": "Resultado de la validacion.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionIdentificacionDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/consultas/comprobantes/decodificar/{claveAcceso}": {
      "get": {
        "tags": [
          "Consultas SRI"
        ],
        "summary": "Decodifica una clave de acceso del SRI.",
        "description": "Separa sus componentes y valida el digito verificador. No consume cupo.",
        "operationId": "decodificarClaveAcceso",
        "parameters": [
          {
            "name": "claveAcceso",
            "in": "path",
            "description": "Clave de acceso de 49 digitos.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1211202601179999999900110010010000001231234567812"
          }
        ],
        "responses": {
          "200": {
            "description": "Componentes y validez de la clave.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClaveAccesoDecodificadaDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/ride": {
      "get": {
        "tags": [
          "Descargas"
        ],
        "summary": "Descarga el RIDE de un comprobante autorizado.",
        "description": "Devuelve el PDF generado por el SRI. Un comprobante no autorizado, inexistente o de\r\nmarca blanca responde 404. No consume cupo.",
        "operationId": "descargarRide",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "claveAcceso",
            "in": "path",
            "description": "Clave de acceso de 49 digitos.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1211202601179999999900110010010000001231234567812"
          }
        ],
        "responses": {
          "200": {
            "description": "PDF del RIDE.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/xml": {
      "get": {
        "tags": [
          "Descargas"
        ],
        "summary": "Descarga el XML de un comprobante autorizado.",
        "description": "Devuelve el XML con nombre de archivo. No consume cupo.",
        "operationId": "descargarXml",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "claveAcceso",
            "in": "path",
            "description": "Clave de acceso de 49 digitos.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1211202601179999999900110010010000001231234567812"
          }
        ],
        "responses": {
          "200": {
            "description": "XML del comprobante.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/operaciones": {
      "get": {
        "tags": [
          "Seguimiento"
        ],
        "summary": "Lista los comprobantes emitidos por un contribuyente.",
        "description": "Devuelve una pagina de operaciones con filtros por fecha, tipo y texto. La\r\nidentificacion debe pertenecer al contexto de la API Key. No consume cupo.",
        "operationId": "listarOperaciones",
        "parameters": [
          {
            "name": "identificacion",
            "in": "query",
            "description": "RUC o identificacion del contribuyente.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "desde",
            "in": "query",
            "description": "Fecha inicial en formato yyyy-MM-dd.",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-01"
          },
          {
            "name": "hasta",
            "in": "query",
            "description": "Fecha final en formato yyyy-MM-dd.",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-12"
          },
          {
            "name": "tipoDocumento",
            "in": "query",
            "description": "Codigo SRI del tipo: 01, 03, 04, 05, 06 o 07.",
            "schema": {
              "type": "string",
              "default": ""
            },
            "example": "01"
          },
          {
            "name": "buscar",
            "in": "query",
            "description": "Texto libre para numero, clave, contraparte o referencia.",
            "schema": {
              "type": "string",
              "default": ""
            },
            "example": "FAC-2026"
          },
          {
            "name": "pagina",
            "in": "query",
            "description": "Numero de pagina, desde 1.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            },
            "example": 1
          },
          {
            "name": "tamanoPagina",
            "in": "query",
            "description": "Filas por pagina, entre 1 y 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            },
            "example": 50
          }
        ],
        "responses": {
          "200": {
            "description": "Pagina de comprobantes del contribuyente.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginaComprobantesDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/operaciones/{id}": {
      "get": {
        "tags": [
          "Seguimiento"
        ],
        "summary": "Consulta una operacion por su identificador.",
        "description": "Devuelve el estado persistido de una emision con la misma forma que la respuesta 202.\r\nEs la ruta de seguimiento mientras el estado sea recibido.",
        "operationId": "consultarOperacion",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador de la operacion.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "200": {
            "description": "Estado actual de la operacion.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/consumo": {
      "get": {
        "tags": [
          "Consumo"
        ],
        "summary": "Consulta el cupo disponible de la integracion.",
        "description": "Devuelve la suma de los paquetes vigentes: limite, documentos reservados, consumidos y disponibles, y el proximo vencimiento.\r\nNo consume cupo.",
        "operationId": "obtenerConsumo",
        "responses": {
          "200": {
            "description": "Cupo vigente y consumo acumulado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuotaBucketDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/facturas": {
      "post": {
        "tags": [
          "Emisión"
        ],
        "summary": "Emite una factura electronica (01).",
        "description": "La ruta fija el tipo 01. Acepta JSON o XML del SRI. Responde 202 con la operacion\r\nadmitida y su estado actual; un replay conserva el 202. Un nuevo intento invalido responde 422.",
        "operationId": "emitirFactura",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Clave idempotente de 1 a 128 caracteres ASCII: letras, digitos y - _ . : /. Repetir la misma clave con el mismo cuerpo devuelve la operacion original; con otro cuerpo responde 409.",
            "required": true,
            "schema": {
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:/-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Datos de la factura: infoTributaria, info, detalles e infoAdicional.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Emision aceptada; sigue la operacion con urlEstado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Location": {
                "$ref": "#/components/headers/Location"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                },
                "example": {
                  "estado": "recibido",
                  "codEstado": 1001,
                  "errores": [ ],
                  "idOperacion": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "ambiente": 1,
                  "tipoDocumento": "01",
                  "numeroDocumento": "001-001-000000001",
                  "referenciaExterna": "FAC-0001",
                  "claveAcceso": null,
                  "fhRecibido": "2026-11-12T10:15:00-05:00",
                  "fhAutorizacion": null
                }
              }
            }
          },
          "422": {
            "description": "Comprobante invalido. Repetir el mismo cuerpo y clave conserva el 422 sin otro consumo; un cuerpo distinto responde 409.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre OperationDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/liquidaciones-compra": {
      "post": {
        "tags": [
          "Emisión"
        ],
        "summary": "Emite una liquidacion de compra (03).",
        "description": "La ruta fija el tipo 03. Acepta JSON o XML del SRI. La liquidacion documenta la compra\r\nde bienes o servicios a un proveedor y sigue el mismo flujo de cupo e idempotencia.",
        "operationId": "emitirLiquidacionCompra",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Clave idempotente de 1 a 128 caracteres ASCII: letras, digitos y - _ . : /. Repetir la misma clave con el mismo cuerpo devuelve la operacion original; con otro cuerpo responde 409.",
            "required": true,
            "schema": {
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:/-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Datos de la liquidacion: info, detalles e infoAdicional.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Emision aceptada; sigue la operacion con urlEstado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Location": {
                "$ref": "#/components/headers/Location"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                },
                "example": {
                  "estado": "recibido",
                  "codEstado": 1001,
                  "errores": [ ],
                  "idOperacion": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "ambiente": 1,
                  "tipoDocumento": "01",
                  "numeroDocumento": "001-001-000000001",
                  "referenciaExterna": "FAC-0001",
                  "claveAcceso": null,
                  "fhRecibido": "2026-11-12T10:15:00-05:00",
                  "fhAutorizacion": null
                }
              }
            }
          },
          "422": {
            "description": "Comprobante invalido. Repetir el mismo cuerpo y clave conserva el 422 sin otro consumo; un cuerpo distinto responde 409.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre OperationDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/notas-credito": {
      "post": {
        "tags": [
          "Emisión"
        ],
        "summary": "Emite una nota de credito (04).",
        "description": "La ruta fija el tipo 04. La nota referencia el documento que modifica mediante\r\ncodDocModificado, numDocModificado y fechaEmisionDocSustento. Acepta JSON o XML.",
        "operationId": "emitirNotaCredito",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Clave idempotente de 1 a 128 caracteres ASCII: letras, digitos y - _ . : /. Repetir la misma clave con el mismo cuerpo devuelve la operacion original; con otro cuerpo responde 409.",
            "required": true,
            "schema": {
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:/-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Datos de la nota de credito, su motivo y sus detalles.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Emision aceptada; sigue la operacion con urlEstado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Location": {
                "$ref": "#/components/headers/Location"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                },
                "example": {
                  "estado": "recibido",
                  "codEstado": 1001,
                  "errores": [ ],
                  "idOperacion": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "ambiente": 1,
                  "tipoDocumento": "01",
                  "numeroDocumento": "001-001-000000001",
                  "referenciaExterna": "FAC-0001",
                  "claveAcceso": null,
                  "fhRecibido": "2026-11-12T10:15:00-05:00",
                  "fhAutorizacion": null
                }
              }
            }
          },
          "422": {
            "description": "Comprobante invalido. Repetir el mismo cuerpo y clave conserva el 422 sin otro consumo; un cuerpo distinto responde 409.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre OperationDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/notas-debito": {
      "post": {
        "tags": [
          "Emisión"
        ],
        "summary": "Emite una nota de debito (05).",
        "description": "La ruta fija el tipo 05. La nota referencia el documento que modifica y declara sus\r\nmotivos e impuestos. Acepta JSON o XML del SRI.",
        "operationId": "emitirNotaDebito",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Clave idempotente de 1 a 128 caracteres ASCII: letras, digitos y - _ . : /. Repetir la misma clave con el mismo cuerpo devuelve la operacion original; con otro cuerpo responde 409.",
            "required": true,
            "schema": {
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:/-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Datos de la nota de debito y sus motivos.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Emision aceptada; sigue la operacion con urlEstado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Location": {
                "$ref": "#/components/headers/Location"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                },
                "example": {
                  "estado": "recibido",
                  "codEstado": 1001,
                  "errores": [ ],
                  "idOperacion": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "ambiente": 1,
                  "tipoDocumento": "01",
                  "numeroDocumento": "001-001-000000001",
                  "referenciaExterna": "FAC-0001",
                  "claveAcceso": null,
                  "fhRecibido": "2026-11-12T10:15:00-05:00",
                  "fhAutorizacion": null
                }
              }
            }
          },
          "422": {
            "description": "Comprobante invalido. Repetir el mismo cuerpo y clave conserva el 422 sin otro consumo; un cuerpo distinto responde 409.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre OperationDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/guias-remision": {
      "post": {
        "tags": [
          "Emisión"
        ],
        "summary": "Emite una guia de remision (06).",
        "description": "La ruta fija el tipo 06. La guia declara el transportista, el traslado y un destinatario\r\ncon el detalle de la mercaderia. Acepta JSON o XML del SRI.",
        "operationId": "emitirGuiaRemision",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Clave idempotente de 1 a 128 caracteres ASCII: letras, digitos y - _ . : /. Repetir la misma clave con el mismo cuerpo devuelve la operacion original; con otro cuerpo responde 409.",
            "required": true,
            "schema": {
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:/-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Datos del traslado y sus destinatarios.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Emision aceptada; sigue la operacion con urlEstado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Location": {
                "$ref": "#/components/headers/Location"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                },
                "example": {
                  "estado": "recibido",
                  "codEstado": 1001,
                  "errores": [ ],
                  "idOperacion": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "ambiente": 1,
                  "tipoDocumento": "01",
                  "numeroDocumento": "001-001-000000001",
                  "referenciaExterna": "FAC-0001",
                  "claveAcceso": null,
                  "fhRecibido": "2026-11-12T10:15:00-05:00",
                  "fhAutorizacion": null
                }
              }
            }
          },
          "422": {
            "description": "Comprobante invalido. Repetir el mismo cuerpo y clave conserva el 422 sin otro consumo; un cuerpo distinto responde 409.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre OperationDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/retenciones": {
      "post": {
        "tags": [
          "Emisión"
        ],
        "summary": "Emite un comprobante de retencion (07).",
        "description": "La ruta fija el tipo 07. El comprobante declara el sujeto retenido y los documentos de\r\nsustento con sus impuestos y retenciones. Acepta JSON o el XML 2.0 con docsSustento.",
        "operationId": "emitirRetencion",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Clave idempotente de 1 a 128 caracteres ASCII: letras, digitos y - _ . : /. Repetir la misma clave con el mismo cuerpo devuelve la operacion original; con otro cuerpo responde 409.",
            "required": true,
            "schema": {
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:/-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Datos de la retencion y sus documentos de sustento.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Emision aceptada; sigue la operacion con urlEstado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Location": {
                "$ref": "#/components/headers/Location"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                },
                "example": {
                  "estado": "recibido",
                  "codEstado": 1001,
                  "errores": [ ],
                  "idOperacion": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "urlEstado": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90",
                  "ambiente": 1,
                  "tipoDocumento": "01",
                  "numeroDocumento": "001-001-000000001",
                  "referenciaExterna": "FAC-0001",
                  "claveAcceso": null,
                  "fhRecibido": "2026-11-12T10:15:00-05:00",
                  "fhAutorizacion": null
                }
              }
            }
          },
          "422": {
            "description": "Comprobante invalido. Repetir el mismo cuerpo y clave conserva el 422 sin otro consumo; un cuerpo distinto responde 409.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre OperationDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/perfil": {
      "get": {
        "tags": [
          "Perfil"
        ],
        "summary": "Consulta el perfil del emisor.",
        "description": "Devuelve los datos editables del emisor y el logo configurado, si existe.",
        "operationId": "obtenerPerfil",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "responses": {
          "200": {
            "description": "Perfil del emisor.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerfilEmisorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "Perfil"
        ],
        "summary": "Actualiza el perfil del emisor.",
        "description": "Es una actualizacion por partes: los campos omitidos o nulos no cambian. El cambio se\r\nrefleja en el RIDE y en los proximos comprobantes. No consume cupo.",
        "operationId": "actualizarPerfil",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Campos editables que se quieren cambiar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PerfilEmisorUpdateDto"
              },
              "example": {
                "nombreComercial": "MI EMPRESA",
                "direccionMatriz": "AV. SIEMPRE VIVA 123",
                "correo": "facturacion@miempresa.com",
                "telefono": "0999999999",
                "ciudad": "Quito",
                "provincia": "Pichincha"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PerfilEmisorUpdateDto"
              },
              "example": {
                "nombreComercial": "MI EMPRESA",
                "direccionMatriz": "AV. SIEMPRE VIVA 123",
                "correo": "facturacion@miempresa.com",
                "telefono": "0999999999",
                "ciudad": "Quito",
                "provincia": "Pichincha"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Perfil actualizado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerfilEmisorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/perfil/logo": {
      "post": {
        "tags": [
          "Perfil"
        ],
        "summary": "Actualiza el logo del emisor.",
        "description": "Acepta multipart/form-data con un archivo PNG o JPEG de hasta 512 KB. El logo se usa\r\nen el RIDE. No consume cupo.",
        "operationId": "actualizarLogoPerfil",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Archivo PNG o JPEG.",
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "logo": {
                    "$ref": "#/components/schemas/IFormFile"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Perfil con el logo actualizado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerfilEmisorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "502": {
            "description": "Un servicio externo reporto un error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "504": {
            "description": "Un servicio externo no respondio a tiempo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/facturas/validar": {
      "post": {
        "tags": [
          "Validación"
        ],
        "summary": "Valida una factura (01) sin emitirla.",
        "description": "Aplica las mismas reglas que la emision, pero no crea operacion ni consume documentos.\r\nNo exige Idempotency-Key. Acepta JSON o XML del SRI.",
        "operationId": "validarFactura",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Factura que se quiere validar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/FacturaRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-01",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "001",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "propina": 0,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "La factura cumple las reglas; valido es true y errores esta vacio.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionComprobanteDto"
                },
                "example": {
                  "valido": true,
                  "errores": [ ]
                }
              }
            }
          },
          "422": {
            "description": "La factura no cumple una regla; errores trae el detalle.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/liquidaciones-compra/validar": {
      "post": {
        "tags": [
          "Validación"
        ],
        "summary": "Valida una liquidacion de compra (03) sin emitirla.",
        "description": "Aplica las mismas reglas que la emision, sin crear operacion ni consumir cupo.\r\nAcepta JSON o XML del SRI.",
        "operationId": "validarLiquidacionCompra",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Liquidacion que se quiere validar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/LiquidacionCompraRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-03",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoPrincipal": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionProveedor": "05",
                  "identificacionProveedor": "0123456789",
                  "razonSocialProveedor": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionProveedor": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "totalDescuento": 0,
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "importeTotal": 1,
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "La liquidacion cumple las reglas.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionComprobanteDto"
                },
                "example": {
                  "valido": true,
                  "errores": [ ]
                }
              }
            }
          },
          "422": {
            "description": "La liquidacion no cumple una regla; errores trae el detalle.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/notas-credito/validar": {
      "post": {
        "tags": [
          "Validación"
        ],
        "summary": "Valida una nota de credito (04) sin emitirla.",
        "description": "Aplica las mismas reglas que la emision, sin crear operacion ni consumir cupo.\r\nAcepta JSON o XML del SRI.",
        "operationId": "validarNotaCredito",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Nota de credito que se quiere validar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaCreditoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-04",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "detalles": [
                  {
                    "descripcion": "DOCUMENTO DE PRUEBA INTEGRACION",
                    "cantidad": 1,
                    "precioUnitario": 1,
                    "descuento": 0,
                    "precioTotalSinImpuesto": 1,
                    "impuestos": [
                      {
                        "codigo": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "valor": 0,
                        "tarifa": 0
                      }
                    ],
                    "codigoInterno": "API-TEST-01"
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "totalConImpuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0
                    }
                  ],
                  "valorModificacion": 1,
                  "motivo": "DEVOLUCION DE PRUEBAS"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "La nota cumple las reglas.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionComprobanteDto"
                },
                "example": {
                  "valido": true,
                  "errores": [ ]
                }
              }
            }
          },
          "422": {
            "description": "La nota no cumple una regla; errores trae el detalle.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/notas-debito/validar": {
      "post": {
        "tags": [
          "Validación"
        ],
        "summary": "Valida una nota de debito (05) sin emitirla.",
        "description": "Aplica las mismas reglas que la emision, sin crear operacion ni consumir cupo.\r\nAcepta JSON o XML del SRI.",
        "operationId": "validarNotaDebito",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Nota de debito que se quiere validar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/NotaDebitoRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-05",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "motivos": [
                  {
                    "razon": "AJUSTE DE PRUEBAS",
                    "valor": 1
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionComprador": "05",
                  "identificacionComprador": "0123456789",
                  "razonSocialComprador": "CONTRIBUYENTE DE PRUEBAS",
                  "direccionComprador": "DIRECCION DE PRUEBAS",
                  "totalSinImpuestos": 1,
                  "moneda": "DOLAR",
                  "codDocModificado": "01",
                  "numDocModificado": "002-001-000000002",
                  "fechaEmisionDocSustento": "10/11/2026",
                  "valorTotal": 1,
                  "impuestos": [
                    {
                      "codigo": "2",
                      "codigoPorcentaje": "0",
                      "baseImponible": 1,
                      "valor": 0,
                      "tarifa": 0
                    }
                  ],
                  "pagos": [
                    {
                      "formaPago": "01",
                      "total": 1,
                      "plazo": 0,
                      "unidadTiempo": "dias"
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "La nota cumple las reglas.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionComprobanteDto"
                },
                "example": {
                  "valido": true,
                  "errores": [ ]
                }
              }
            }
          },
          "422": {
            "description": "La nota no cumple una regla; errores trae el detalle.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/guias-remision/validar": {
      "post": {
        "tags": [
          "Validación"
        ],
        "summary": "Valida una guia de remision (06) sin emitirla.",
        "description": "Aplica las mismas reglas que la emision, sin crear operacion ni consumir cupo.\r\nAcepta JSON o XML del SRI.",
        "operationId": "validarGuiaRemision",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Guia de remision que se quiere validar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/GuiaRemisionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-06",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "destinatarios": [
                  {
                    "identificacionDestinatario": "0123456789",
                    "razonSocialDestinatario": "CONTRIBUYENTE DE PRUEBAS",
                    "dirDestinatario": "DESTINO PRUEBAS",
                    "motivoTraslado": "TRASLADO DE PRUEBAS",
                    "codEstabDestino": "001",
                    "ruta": "RUTA DE PRUEBAS",
                    "detalles": [
                      {
                        "codigoInterno": "API-TEST-01",
                        "descripcion": "TRASLADO DE PRUEBA",
                        "cantidad": 1
                      }
                    ]
                  }
                ],
                "info": {
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "dirPartida": "ORIGEN PRUEBAS",
                  "razonSocialTransportista": "CONDUCTOR DE PRUEBAS",
                  "tipoIdentificacionTransportista": "05",
                  "rucTransportista": "0123456789",
                  "fechaIniTransporte": "10/11/2026",
                  "fechaFinTransporte": "10/11/2026",
                  "placa": "PBA0001"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "La guia cumple las reglas.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionComprobanteDto"
                },
                "example": {
                  "valido": true,
                  "errores": [ ]
                }
              }
            }
          },
          "422": {
            "description": "La guia no cumple una regla; errores trae el detalle.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/contribuyentes/{identificacion}/retenciones/validar": {
      "post": {
        "tags": [
          "Validación"
        ],
        "summary": "Valida un comprobante de retencion (07) sin emitirlo.",
        "description": "Aplica las mismas reglas que la emision, sin crear operacion ni consumir cupo.\r\nAcepta JSON o el XML 2.0 con docsSustento.",
        "operationId": "validarRetencion",
        "parameters": [
          {
            "name": "identificacion",
            "in": "path",
            "description": "Identificación completa del contribuyente, la misma de infoTributaria.ruc (5 a 13 dígitos).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0921357232001"
          }
        ],
        "requestBody": {
          "description": "Retencion que se quiere validar.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/ComprobanteRetencionRequestDto"
              },
              "example": {
                "origenReferencia": "ejemplo-docs",
                "referenciaExterna": "example-07",
                "infoTributaria": {
                  "ruc": "0123456789001",
                  "estab": "002",
                  "ptoEmi": "001",
                  "secuencial": "000000000"
                },
                "infoAdicional": [
                  {
                    "nombre": "Prueba",
                    "valor": "AMBIENTE DE PRUEBAS"
                  }
                ],
                "docsSustento": [
                  {
                    "codSustento": "01",
                    "codDocSustento": "01",
                    "numDocSustento": "002001000000002",
                    "fechaEmisionDocSustento": "10/11/2026",
                    "fechaRegistroContable": "10/11/2026",
                    "numAutDocSustento": "0709202601012345678900110020010000000029846951114",
                    "pagoLocExt": "01",
                    "totalSinImpuestos": 1,
                    "importeTotal": 1,
                    "impuestosDocSustento": [
                      {
                        "codImpuestoDocSustento": "2",
                        "codigoPorcentaje": "0",
                        "baseImponible": 1,
                        "tarifa": 0,
                        "valorImpuesto": 0
                      }
                    ],
                    "retenciones": [
                      {
                        "codigo": "1",
                        "codigoRetencion": "303",
                        "baseImponible": 1,
                        "porcentajeRetener": 10,
                        "valorRetenido": 0.10
                      }
                    ],
                    "pagos": [
                      {
                        "formaPago": "01",
                        "total": 1,
                        "plazo": 0,
                        "unidadTiempo": "dias"
                      }
                    ]
                  }
                ],
                "info": {
                  "fechaEmision": "10/11/2026",
                  "dirEstablecimiento": "DIRECCION DE PRUEBAS",
                  "tipoIdentificacionSujetoRetenido": "05",
                  "razonSocialSujetoRetenido": "CONTRIBUYENTE DE PRUEBAS",
                  "identificacionSujetoRetenido": "0123456789",
                  "parteRel": "NO",
                  "periodoFiscal": "09/2026"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "La retencion cumple las reglas.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidacionComprobanteDto"
                },
                "example": {
                  "valido": true,
                  "errores": [ ]
                }
              }
            }
          },
          "422": {
            "description": "La retencion no cumple una regla; errores trae el detalle.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Lista los destinos de webhooks de la integracion.",
        "description": "Devuelve los destinos visibles para los RUC de la API Key, con su estado y eventos.",
        "operationId": "listarDestinosWebhook",
        "responses": {
          "200": {
            "description": "Destinos de webhooks.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebhookEndpointDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Crea un destino de webhooks.",
        "description": "El destino recibe eventos de uno o todos los RUC. El secreto de firma se devuelve una\r\nsola vez; guardalo en tu gestor de secretos.",
        "operationId": "crearDestinoWebhook",
        "requestBody": {
          "description": "URL HTTPS, RUC y eventos suscritos.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDestinoCrearRequest"
              },
              "example": {
                "url": "https://miempresa.com/webhooks/ecuafact",
                "eventos": [
                  "document.authorized",
                  "document.rejected",
                  "document.failed"
                ],
                "ruc": "0123456789001"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDestinoCrearRequest"
              },
              "example": {
                "url": "https://miempresa.com/webhooks/ecuafact",
                "eventos": [
                  "document.authorized",
                  "document.rejected",
                  "document.failed"
                ],
                "ruc": "0123456789001"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDestinoCrearRequest"
              },
              "example": {
                "url": "https://miempresa.com/webhooks/ecuafact",
                "eventos": [
                  "document.authorized",
                  "document.rejected",
                  "document.failed"
                ],
                "ruc": "0123456789001"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Destino creado; incluye el secreto una sola vez.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookEndpointCreatedDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Consulta un destino de webhooks.",
        "description": "Devuelve la configuracion y el estado de un destino de webhooks.",
        "operationId": "obtenerDestinoWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "200": {
            "description": "Configuracion y estado del destino.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookEndpointDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/eventos": {
      "put": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Reemplaza los eventos de un destino.",
        "description": "Reemplaza la lista de eventos que recibe un destino de webhooks.",
        "operationId": "actualizarEventosWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "requestBody": {
          "description": "Lista completa de eventos que debe recibir.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDestinoEventosRequest"
              },
              "example": {
                "eventos": [
                  "document.authorized",
                  "document.rejected"
                ]
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDestinoEventosRequest"
              },
              "example": {
                "eventos": [
                  "document.authorized",
                  "document.rejected"
                ]
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookDestinoEventosRequest"
              },
              "example": {
                "eventos": [
                  "document.authorized",
                  "document.rejected"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "Eventos actualizados. Sin contenido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/rotar-secreto": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Rota el secreto de firma de un destino.",
        "description": "El secreto anterior deja de ser valido. El nuevo se devuelve una sola vez.",
        "operationId": "rotarSecretoWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "200": {
            "description": "Destino con el secreto nuevo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookEndpointCreatedDto"
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/probar": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Envia un evento de prueba a un destino.",
        "description": "El evento de prueba es informativo y no representa un comprobante real.",
        "operationId": "probarWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "202": {
            "description": "Evento de prueba aceptado. Sin contenido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/pausar": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Pausa las entregas de un destino.",
        "description": "Pausa las entregas del destino sin borrar su configuracion.",
        "operationId": "pausarWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "204": {
            "description": "Destino pausado. Sin contenido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/reanudar": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Reanuda las entregas de un destino pausado.",
        "description": "Reanuda las entregas de un destino pausado.",
        "operationId": "reanudarWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "204": {
            "description": "Destino reanudado. Sin contenido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/deshabilitar": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Deshabilita un destino de webhooks.",
        "description": "Deshabilita el destino y deja de entregar eventos.",
        "operationId": "deshabilitarWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "204": {
            "description": "Destino deshabilitado. Sin contenido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/entregas": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Lista las entregas de un destino.",
        "description": "Devuelve las entregas del destino con su resultado y sus intentos.",
        "operationId": "listarEntregasWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          }
        ],
        "responses": {
          "200": {
            "description": "Entregas con su resultado e intentos.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebhookDeliveryDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/entregas/{entregaId}/intentos": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Lista los intentos de una entrega.",
        "description": "Devuelve los intentos de una entrega, con el codigo HTTP y el error de cada uno.",
        "operationId": "listarIntentosEntregaWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          },
          {
            "name": "entregaId",
            "in": "path",
            "description": "Identificador de la entrega.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "8a1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d"
          }
        ],
        "responses": {
          "200": {
            "description": "Intentos con codigo HTTP y error.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebhookDeliveryAttemptDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    },
    "/v1/webhooks/destinos/{id}/entregas/{eventoId}/reintentar": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Reencola una entrega fallida o rechazada.",
        "description": "Reencola una entrega fallida o rechazada para el mismo destino.",
        "operationId": "reintentarEntregaWebhook",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Identificador publico del destino.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
          },
          {
            "name": "eventoId",
            "in": "path",
            "description": "Identificador del evento que se quiere reintentar.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "5b6c7d8e-9f01-4a2b-8c3d-4e5f6a7b8c9d"
          }
        ],
        "responses": {
          "202": {
            "description": "Reintento aceptado. Sin contenido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            }
          },
          "400": {
            "description": "Solicitud invalida: JSON o XML mal formado, parametros o filtros invalidos, o version de API no admitida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "401": {
            "description": "API Key ausente, invalida, revocada o vencida.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "403": {
            "description": "IP no permitida o no identificable, o contribuyente, tipo de documento o suscripcion no habilitados.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "404": {
            "description": "Recurso no encontrado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "409": {
            "description": "Conflicto: comprobante duplicado, Idempotency-Key usada con otro contenido, o correo no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "413": {
            "description": "Cuerpo de la solicitud excedido.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "415": {
            "description": "Tipo de contenido no admitido; se espera application/json o application/xml en la emision, y application/json o multipart/form-data en el resto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "422": {
            "description": "Comprobante o datos invalidos; errores trae el detalle por campo.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "429": {
            "description": "Limite de solicitudes excedido o cupo agotado.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-RateLimit-Reset": {
                "$ref": "#/components/headers/X-RateLimit-Reset"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "500": {
            "description": "Error interno.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "503": {
            "description": "Servicio temporalmente no disponible.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          },
          "default": {
            "description": "Error con el sobre ErrorDto.",
            "headers": {
              "X-Correlation-Id": {
                "$ref": "#/components/headers/X-Correlation-Id"
              },
              "X-Api-Version": {
                "$ref": "#/components/headers/X-Api-Version"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/X-RateLimit-Limit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/X-RateLimit-Remaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": [ ]
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "BusquedaContribuyenteDto": {
        "required": [
          "identificacion",
          "tipoIdentificacion",
          "nombreCompleto",
          "clase",
          "estado",
          "fuenteOrigen"
        ],
        "type": "object",
        "properties": {
          "identificacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipoIdentificacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "nombreCompleto": {
            "type": [
              "null",
              "string"
            ]
          },
          "clase": {
            "type": [
              "null",
              "string"
            ]
          },
          "estado": {
            "type": [
              "null",
              "string"
            ]
          },
          "fuenteOrigen": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "CampoAdicionalDto": {
        "required": [
          "nombre",
          "valor"
        ],
        "type": "object",
        "properties": {
          "nombre": {
            "examples": [
              "email"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Nombre del campo adicional."
          },
          "valor": {
            "examples": [
              "cliente@example.test"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Valor del campo adicional."
          }
        },
        "description": "Campo adicional del comprobante expresado como par nombre/valor."
      },
      "CatalogoDetalleDto": {
        "required": [
          "nombre",
          "descripcion",
          "fuente",
          "items"
        ],
        "type": "object",
        "properties": {
          "nombre": {
            "type": "string",
            "description": "Clave del catalogo."
          },
          "descripcion": {
            "type": "string",
            "description": "Descripcion breve del catalogo."
          },
          "fuente": {
            "type": "string",
            "description": "Tabla o anexo de la ficha tecnica del SRI de donde proviene."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogoItemDto"
            },
            "description": "Filas del catalogo."
          }
        },
        "description": "Detalle de un catalogo del SRI."
      },
      "CatalogoItemDto": {
        "required": [
          "codigo",
          "descripcion",
          "valor",
          "vigenteDesde",
          "vigenteHasta",
          "atributos"
        ],
        "type": "object",
        "properties": {
          "codigo": {
            "type": "string",
            "description": "Codigo tal como va en el comprobante."
          },
          "descripcion": {
            "type": "string",
            "description": "Descripcion del codigo."
          },
          "valor": {
            "type": [
              "null",
              "number"
            ],
            "description": "Valor numerico asociado, por ejemplo la tarifa en porcentaje. Se omite si el catalogo no lo tiene.",
            "format": "double"
          },
          "vigenteDesde": {
            "type": [
              "null",
              "string"
            ],
            "description": "Primer dia de vigencia (yyyy-MM-dd). Se omite si no esta acotada por el inicio.",
            "format": "date"
          },
          "vigenteHasta": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ultimo dia de vigencia (yyyy-MM-dd). Se omite si sigue vigente.",
            "format": "date"
          },
          "atributos": {
            "type": [
              "null",
              "object"
            ],
            "description": "Atributos propios del catalogo. Se omite si no hay."
          }
        },
        "description": "Fila de un catalogo del SRI."
      },
      "CatalogoResumenDto": {
        "required": [
          "nombre",
          "descripcion"
        ],
        "type": "object",
        "properties": {
          "nombre": {
            "type": "string",
            "description": "Clave del catalogo; es el valor que va en la ruta de detalle."
          },
          "descripcion": {
            "type": "string",
            "description": "Descripcion breve de lo que contiene el catalogo."
          }
        },
        "description": "Entrada del indice de catalogos del SRI."
      },
      "CatalogosDto": {
        "required": [
          "catalogos"
        ],
        "type": "object",
        "properties": {
          "catalogos": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogoResumenDto"
            },
            "description": "Catalogos disponibles, en el orden de la ficha tecnica."
          }
        },
        "description": "Respuesta del indice de catalogos."
      },
      "ClaveAccesoDecodificadaDto": {
        "required": [
          "entrada",
          "normalizada",
          "valido",
          "longitud",
          "fechaEmision",
          "tipo",
          "rucEmisor",
          "ambiente",
          "establecimiento",
          "puntoEmision",
          "secuencial",
          "codigoNumerico",
          "tipoEmision",
          "tipoEmisionDescripcion",
          "digitoVerificador",
          "mensaje"
        ],
        "type": "object",
        "properties": {
          "entrada": {
            "type": [
              "null",
              "string"
            ]
          },
          "normalizada": {
            "type": [
              "null",
              "string"
            ]
          },
          "valido": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "longitud": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "fechaEmision": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipo": {
            "type": [
              "null",
              "string"
            ]
          },
          "rucEmisor": {
            "type": [
              "null",
              "string"
            ]
          },
          "ambiente": {
            "type": [
              "null",
              "string"
            ]
          },
          "establecimiento": {
            "type": [
              "null",
              "string"
            ]
          },
          "puntoEmision": {
            "type": [
              "null",
              "string"
            ]
          },
          "secuencial": {
            "type": [
              "null",
              "string"
            ]
          },
          "codigoNumerico": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipoEmision": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipoEmisionDescripcion": {
            "type": [
              "null",
              "string"
            ]
          },
          "digitoVerificador": {
            "type": "string",
            "description": "Digito verificador calculado del ultimo caracter de la clave de acceso."
          },
          "mensaje": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "CodEstado": {
        "enum": [
          1001,
          1002,
          2001,
          3001,
          3002,
          3003,
          3004,
          3005,
          3006,
          3007,
          3008,
          3009,
          3010,
          3011,
          3012,
          3013,
          3014,
          4001,
          4002,
          4003,
          4004,
          5001,
          5002,
          5003,
          5004,
          5005,
          5006,
          5007,
          6001
        ],
        "type": "integer",
        "description": "Codigo del resultado (catalogo codEstado). El primer digito es el estado: 1xxx recibido, 2xxx autorizado, 3xxx rechazado, 4xxx rechazo_configuracion, 5xxx error, 6xxx cancelado. 1001 comprobante_recibido; 1002 comprobante_enviado; 2001 comprobante_autorizado; 3001 rechazo_sri; 3002 comprobante_invalido; 3003 solicitud_invalida; 3004 comprobante_duplicado; 3005 conflicto_idempotencia; 3006 cuerpo_excedido; 3007 version_no_soportada; 3008 no_implementado; 3009 credenciales_invalidas; 3010 ip_no_autorizada; 3011 acceso_denegado; 3012 filtros_invalidos; 3013 no_encontrado; 3014 correo_no_disponible; 4001 emisor_no_configurado; 4002 firma_no_valida; 4003 suscripcion_inactiva; 4004 cupo_agotado; 5001 error_interno; 5002 servicio_no_disponible; 5003 error_dependencia; 5004 tiempo_agotado; 5005 limite_solicitudes; 5006 entrega_no_posible; 5007 resultado_no_confirmado; 6001 operacion_cancelada.",
        "format": "int32"
      },
      "ComprobanteDto": {
        "required": [
          "claveAcceso",
          "numeroDocumento",
          "tipoDocumento",
          "fechaEmision",
          "identificacionContraparte",
          "razonSocialContraparte",
          "total",
          "estado",
          "codEstado",
          "errores",
          "fhAutorizacion"
        ],
        "type": "object",
        "properties": {
          "claveAcceso": {
            "type": "string"
          },
          "numeroDocumento": {
            "type": "string"
          },
          "tipoDocumento": {
            "enum": [
              "01",
              "03",
              "04",
              "05",
              "06",
              "07"
            ],
            "type": "string",
            "description": "Tipo de comprobante: 01, 03, 04, 05, 06 o 07."
          },
          "fechaEmision": {
            "type": "string"
          },
          "identificacionContraparte": {
            "type": "string"
          },
          "razonSocialContraparte": {
            "type": "string"
          },
          "total": {
            "type": "number",
            "format": "double"
          },
          "estado": {
            "$ref": "#/components/schemas/EstadoPublico"
          },
          "codEstado": {
            "$ref": "#/components/schemas/CodEstado"
          },
          "msgError": {
            "type": [
              "null",
              "string"
            ],
            "description": "Descripcion general y fija del codEstado. Se omite cuando no hay error."
          },
          "errores": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Detalle especifico (ruta del campo, mensaje del SRI); lista vacia si no hay detalle."
          },
          "fhAutorizacion": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "description": "Fila del listado de comprobantes emitidos. estado, codEstado, msgError (se omite cuando no hay error) y errores\r\ntienen el mismo significado que en el seguimiento de una operacion."
      },
      "ComprobanteRetencionRequestDto": {
        "required": [
          "origenReferencia",
          "referenciaExterna",
          "infoTributaria",
          "info",
          "docsSustento"
        ],
        "type": "object",
        "properties": {
          "info": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Informacion de la retencion: sujeto retenido, periodo y parte relacionada.",
                "$ref": "#/components/schemas/InfoComprobanteRetencionDto"
              }
            ]
          },
          "docsSustento": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DocsSustentoDto"
            },
            "description": "Documentos de sustento de la retencion, con sus impuestos y retenciones."
          },
          "origenReferencia": {
            "examples": [
              "mi-erp"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador del sistema o producto que origina el comprobante; se usa como espacio de\r\nreferencia para la idempotencia del envio."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia empresarial propia del emisor para el comprobante; debe ser estable en reintentos\r\npara no duplicar emisiones."
          },
          "infoTributaria": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Datos tributarios comunes de todo comprobante: RUC del emisor, serie y secuencial.",
                "$ref": "#/components/schemas/InfoTributariaDto"
              }
            ]
          },
          "infoAdicional": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Informacion adicional libre del comprobante como pares nombre/valor; el SRI la usa para\r\nanexos obligatorios (por ejemplo, el RUC del proveedor de software)."
          }
        },
        "description": "Comprobante de retencion (codigo 07). Contrato de entrada del endpoint\r\n/v1/contribuyentes/{identificacion}/retenciones."
      },
      "ContextoDto": {
        "required": [
          "idCliente",
          "nombre",
          "contribuyentes"
        ],
        "type": "object",
        "properties": {
          "idCliente": {
            "type": "string",
            "format": "uuid"
          },
          "nombre": {
            "type": "string"
          },
          "contribuyentes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContribuyenteDto"
            }
          }
        }
      },
      "ContribuyenteConsultaDto": {
        "required": [
          "identificacion",
          "tipoIdentificacion",
          "nombreCompleto",
          "razonSocial",
          "nombreComercial",
          "clase",
          "estado",
          "regimen",
          "actividadEconomicaPrincipal",
          "obligadoLlevarContabilidad",
          "agenteRetencion",
          "contribuyenteEspecial",
          "fechaInicioActividades",
          "fechaCese",
          "fechaReinicioActividades",
          "fechaActualizacion",
          "representantesLegales",
          "establecimientos",
          "estadoTributario",
          "fuenteOrigen",
          "consultadoEn"
        ],
        "type": "object",
        "properties": {
          "identificacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipoIdentificacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "nombreCompleto": {
            "type": [
              "null",
              "string"
            ]
          },
          "razonSocial": {
            "type": [
              "null",
              "string"
            ]
          },
          "nombreComercial": {
            "type": [
              "null",
              "string"
            ]
          },
          "clase": {
            "type": [
              "null",
              "string"
            ]
          },
          "estado": {
            "type": [
              "null",
              "string"
            ]
          },
          "regimen": {
            "type": [
              "null",
              "string"
            ]
          },
          "actividadEconomicaPrincipal": {
            "type": [
              "null",
              "string"
            ]
          },
          "obligadoLlevarContabilidad": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "agenteRetencion": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "contribuyenteEspecial": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "fechaInicioActividades": {
            "type": [
              "null",
              "string"
            ]
          },
          "fechaCese": {
            "type": [
              "null",
              "string"
            ]
          },
          "fechaReinicioActividades": {
            "type": [
              "null",
              "string"
            ]
          },
          "fechaActualizacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "representantesLegales": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/RepresentanteLegalDto"
            }
          },
          "establecimientos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/EstablecimientoConsultaDto"
            }
          },
          "estadoTributario": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EstadoTributarioDto"
              }
            ]
          },
          "fuenteOrigen": {
            "type": [
              "null",
              "string"
            ]
          },
          "consultadoEn": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "ContribuyenteDto": {
        "required": [
          "identificacion",
          "puedeEmitir",
          "puedeRecibir",
          "tiposComprobante",
          "marcaBlanca"
        ],
        "type": "object",
        "properties": {
          "identificacion": {
            "type": "string",
            "description": "Identificacion completa del contribuyente, la misma de infoTributaria.ruc."
          },
          "puedeEmitir": {
            "type": "boolean",
            "description": "La credencial puede emitir para este contribuyente."
          },
          "puedeRecibir": {
            "type": "boolean",
            "description": "La credencial puede consultar comprobantes recibidos."
          },
          "tiposComprobante": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Codigos SRI habilitados para el contribuyente."
          },
          "marcaBlanca": {
            "type": "boolean",
            "description": "El emisor no genera RIDE ni envia correo; el XML se descarga igual."
          }
        },
        "description": "Contribuyente del contexto de la credencial."
      },
      "DestinatarioDto": {
        "required": [
          "identificacionDestinatario",
          "razonSocialDestinatario",
          "dirDestinatario",
          "motivoTraslado",
          "detalles"
        ],
        "type": "object",
        "properties": {
          "identificacionDestinatario": {
            "examples": [
              "0123456789"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de identificacion del destinatario (cedula o RUC)."
          },
          "razonSocialDestinatario": {
            "examples": [
              "Destino de prueba"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Nombre o razon social del destinatario."
          },
          "dirDestinatario": {
            "examples": [
              "Av. Amazonas 123, Quito"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion de entrega al destinatario."
          },
          "motivoTraslado": {
            "examples": [
              "Venta"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Motivo del traslado hacia este destinatario."
          },
          "docAduaneroUnico": {
            "type": [
              "null",
              "string"
            ],
            "description": "Documento aduanero unico cuando el traslado involucra comercio exterior."
          },
          "codEstabDestino": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del establecimiento de destino de la mercaderia."
          },
          "ruta": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ruta o itinerario del traslado."
          },
          "detalles": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DetalleGuiaDto"
            },
            "description": "Detalle de la mercaderia trasladada (sin precios ni impuestos)."
          }
        },
        "description": "Destinatario de una guia de remision: quien recibe la mercaderia y que se le traslada."
      },
      "DetalleCompraVentaDto": {
        "required": [
          "codigoPrincipal",
          "descripcion",
          "cantidad",
          "precioUnitario",
          "descuento",
          "precioTotalSinImpuesto",
          "impuestos"
        ],
        "type": "object",
        "properties": {
          "codigoPrincipal": {
            "examples": [
              "P001"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo principal del bien o servicio."
          },
          "codigoAuxiliar": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo auxiliar o secundario del bien o servicio, cuando existe."
          },
          "descripcion": {
            "examples": [
              "Servicio de consultoria"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Descripcion del bien o servicio vendido."
          },
          "cantidad": {
            "type": [
              "null",
              "number"
            ],
            "description": "Cantidad del bien o servicio en la linea.",
            "format": "double"
          },
          "precioUnitario": {
            "type": [
              "null",
              "number"
            ],
            "description": "Precio unitario del bien o servicio.",
            "format": "double"
          },
          "descuento": {
            "type": [
              "null",
              "number"
            ],
            "description": "Descuento aplicado a la linea.",
            "format": "double"
          },
          "precioTotalSinImpuesto": {
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la linea sin impuestos (cantidad por precio menos descuento).",
            "format": "double"
          },
          "impuestos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDto"
            },
            "description": "Impuestos aplicados a la linea, con su codigo, porcentaje, tarifa, base y valor."
          },
          "detallesAdicionales": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Atributos adicionales de la linea (hasta tres pares nombre/valor)."
          }
        },
        "description": "Linea de detalle de factura o liquidacion de compra: identifica el bien o servicio, la cantidad,\r\nlos precios, descuentos e impuestos aplicados a la linea."
      },
      "DetalleGuiaDto": {
        "required": [
          "codigoInterno",
          "descripcion",
          "cantidad"
        ],
        "type": "object",
        "properties": {
          "codigoInterno": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo interno de la linea."
          },
          "codigoAdicional": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo adicional de la linea."
          },
          "descripcion": {
            "type": [
              "null",
              "string"
            ],
            "description": "Descripcion del bien trasladado."
          },
          "cantidad": {
            "type": [
              "null",
              "number"
            ],
            "description": "Cantidad del bien trasladado.",
            "format": "double"
          },
          "detallesAdicionales": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Atributos adicionales de la linea (hasta tres pares nombre/valor)."
          }
        },
        "description": "Linea de detalle de una guia de remision: identifica la mercaderia trasladada, sin precios ni\r\nimpuestos."
      },
      "DetalleNotaCreditoDto": {
        "required": [
          "codigoInterno",
          "descripcion",
          "cantidad",
          "precioUnitario",
          "descuento",
          "precioTotalSinImpuesto",
          "impuestos"
        ],
        "type": "object",
        "properties": {
          "codigoInterno": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo interno de la linea."
          },
          "codigoAdicional": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo adicional de la linea."
          },
          "descripcion": {
            "type": [
              "null",
              "string"
            ],
            "description": "Descripcion del bien o servicio acreditado."
          },
          "cantidad": {
            "type": [
              "null",
              "number"
            ],
            "description": "Cantidad del bien o servicio en la linea.",
            "format": "double"
          },
          "precioUnitario": {
            "type": [
              "null",
              "number"
            ],
            "description": "Precio unitario del bien o servicio.",
            "format": "double"
          },
          "descuento": {
            "type": [
              "null",
              "number"
            ],
            "description": "Descuento aplicado a la linea.",
            "format": "double"
          },
          "precioTotalSinImpuesto": {
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la linea sin impuestos (cantidad por precio menos descuento).",
            "format": "double"
          },
          "impuestos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDto"
            },
            "description": "Impuestos aplicados a la linea."
          },
          "detallesAdicionales": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Atributos adicionales de la linea (hasta tres pares nombre/valor)."
          }
        },
        "description": "Linea de detalle de una nota de credito: usa codigo interno y adicional en lugar del codigo\r\nprincipal de la factura."
      },
      "DocsSustentoDto": {
        "required": [
          "codSustento",
          "codDocSustento",
          "numDocSustento",
          "fechaEmisionDocSustento",
          "fechaRegistroContable",
          "pagoLocExt",
          "totalSinImpuestos",
          "importeTotal",
          "impuestosDocSustento",
          "pagos",
          "retenciones"
        ],
        "type": "object",
        "properties": {
          "codSustento": {
            "examples": [
              "01"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del sustento (por ejemplo, tipo de renta o servicio que origina la retencion)."
          },
          "codDocSustento": {
            "examples": [
              "01"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de documento que sustenta la retencion."
          },
          "numDocSustento": {
            "examples": [
              "001001000000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero del documento de sustento (15 digitos sin guiones)."
          },
          "fechaEmisionDocSustento": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision del documento de sustento."
          },
          "fechaRegistroContable": {
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha en que registraste el documento de sustento en tu contabilidad, `dd/MM/yyyy`. Obligatoria."
          },
          "numAutDocSustento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de autorizacion del sustento cuando es un comprobante electronico."
          },
          "pagoLocExt": {
            "type": [
              "null",
              "string"
            ],
            "description": "Indica si el pago es local (01) o al exterior (02)."
          },
          "totalSinImpuestos": {
            "examples": [
              100.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la operacion del sustento sin impuestos.",
            "format": "double"
          },
          "importeTotal": {
            "examples": [
              115.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Importe total del sustento.",
            "format": "double"
          },
          "impuestosDocSustento": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDocSustentoDto"
            },
            "description": "Impuestos del documento de sustento, desglosados por impuesto y tarifa."
          },
          "retenciones": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/RetencionLineaDto"
            },
            "description": "Retenciones practicadas sobre el sustento, una por codigo y base retenida."
          },
          "pagos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PagoDto"
            },
            "description": "Formas de pago del documento de sustento."
          }
        },
        "description": "Documento de sustento de un comprobante de retencion: identifica el documento sobre el cual se\r\npractica la retencion, sus impuestos, retenciones y pagos."
      },
      "ErrorDto": {
        "required": [
          "estado",
          "codEstado",
          "msgError",
          "errores"
        ],
        "type": "object",
        "properties": {
          "estado": {
            "enum": [
              "rechazado",
              "rechazo_configuracion",
              "error"
            ],
            "type": "string",
            "description": "Estado del codEstado: rechazado (3xxx), rechazo_configuracion (4xxx) o error (5xxx)."
          },
          "codEstado": {
            "enum": [
              3002,
              3003,
              3004,
              3005,
              3006,
              3007,
              3008,
              3009,
              3010,
              3011,
              3012,
              3013,
              3014,
              4004,
              5001,
              5002,
              5003,
              5004,
              5005
            ],
            "type": "integer",
            "description": "Codigo del catalogo codEstado.",
            "format": "int32"
          },
          "msgError": {
            "type": "string",
            "description": "Descripcion general y fija del codEstado."
          },
          "errores": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Detalle de la validacion (campo y motivo); lista vacia en el resto de errores."
          }
        },
        "description": "Sobre de toda respuesta de error 4xx y 5xx (salvo la emision, que responde con OperationDto). El identificador de correlacion viaja en la cabecera X-Correlation-Id."
      },
      "EstablecimientoConsultaDto": {
        "required": [
          "numero",
          "nombreComercial",
          "tipo",
          "direccionCompleta",
          "estado",
          "esMatriz"
        ],
        "type": "object",
        "properties": {
          "numero": {
            "type": [
              "null",
              "string"
            ]
          },
          "nombreComercial": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipo": {
            "type": [
              "null",
              "string"
            ]
          },
          "direccionCompleta": {
            "type": [
              "null",
              "string"
            ]
          },
          "estado": {
            "type": [
              "null",
              "string"
            ]
          },
          "esMatriz": {
            "type": [
              "null",
              "boolean"
            ]
          }
        }
      },
      "EstablecimientosConsultaDto": {
        "required": [
          "ruc",
          "filtro",
          "cantidad",
          "establecimientos"
        ],
        "type": "object",
        "properties": {
          "ruc": {
            "type": [
              "null",
              "string"
            ]
          },
          "filtro": {
            "type": [
              "null",
              "string"
            ]
          },
          "cantidad": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "establecimientos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/EstablecimientoConsultaDto"
            }
          }
        }
      },
      "EstadoPublico": {
        "enum": [
          "recibido",
          "autorizado",
          "rechazado",
          "rechazo_configuracion",
          "error",
          "cancelado"
        ],
        "type": "string",
        "description": "Estado publico del comprobante: recibido mientras no hay resultado final; autorizado, rechazado, rechazo_configuracion, error y cancelado son finales."
      },
      "EstadoTributarioDto": {
        "required": [
          "tieneDeuda",
          "tieneImpugnacion",
          "tieneRemision",
          "resumenDeuda",
          "resumenImpugnacion",
          "resumenRemision",
          "consultadoEn"
        ],
        "type": "object",
        "properties": {
          "tieneDeuda": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "tieneImpugnacion": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "tieneRemision": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "resumenDeuda": {
            "type": [
              "null",
              "string"
            ]
          },
          "resumenImpugnacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "resumenRemision": {
            "type": [
              "null",
              "string"
            ]
          },
          "consultadoEn": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "FacturaRequestDto": {
        "required": [
          "origenReferencia",
          "referenciaExterna",
          "infoTributaria",
          "info",
          "detalles"
        ],
        "type": "object",
        "properties": {
          "info": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Informacion de la factura: comprador, totales, pagos y datos de exportacion.",
                "$ref": "#/components/schemas/InfoFacturaDto"
              }
            ]
          },
          "detalles": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DetalleCompraVentaDto"
            },
            "description": "Lineas de detalle de la factura."
          },
          "origenReferencia": {
            "examples": [
              "mi-erp"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador del sistema o producto que origina el comprobante; se usa como espacio de\r\nreferencia para la idempotencia del envio."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia empresarial propia del emisor para el comprobante; debe ser estable en reintentos\r\npara no duplicar emisiones."
          },
          "infoTributaria": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Datos tributarios comunes de todo comprobante: RUC del emisor, serie y secuencial.",
                "$ref": "#/components/schemas/InfoTributariaDto"
              }
            ]
          },
          "infoAdicional": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Informacion adicional libre del comprobante como pares nombre/valor; el SRI la usa para\r\nanexos obligatorios (por ejemplo, el RUC del proveedor de software)."
          }
        },
        "description": "Factura (codigo 01). Contrato de entrada del endpoint /v1/contribuyentes/{identificacion}/facturas."
      },
      "FiscalEnvironment": {
        "enum": [
          1,
          2
        ],
        "type": "integer",
        "description": "Ambiente fiscal del comprobante: 1 pruebas, 2 produccion."
      },
      "GuiaRemisionRequestDto": {
        "required": [
          "origenReferencia",
          "referenciaExterna",
          "infoTributaria",
          "info",
          "destinatarios"
        ],
        "type": "object",
        "properties": {
          "info": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Informacion del traslado: transportista, fechas y placa.",
                "$ref": "#/components/schemas/InfoGuiaRemisionDto"
              }
            ]
          },
          "destinatarios": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DestinatarioDto"
            },
            "description": "Destinatarios de la guia con la identificacion y el detalle de lo trasladado."
          },
          "origenReferencia": {
            "examples": [
              "mi-erp"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador del sistema o producto que origina el comprobante; se usa como espacio de\r\nreferencia para la idempotencia del envio."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia empresarial propia del emisor para el comprobante; debe ser estable en reintentos\r\npara no duplicar emisiones."
          },
          "infoTributaria": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Datos tributarios comunes de todo comprobante: RUC del emisor, serie y secuencial.",
                "$ref": "#/components/schemas/InfoTributariaDto"
              }
            ]
          },
          "infoAdicional": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Informacion adicional libre del comprobante como pares nombre/valor; el SRI la usa para\r\nanexos obligatorios (por ejemplo, el RUC del proveedor de software)."
          }
        },
        "description": "Guia de remision (codigo 06). Contrato de entrada del endpoint\r\n/v1/contribuyentes/{identificacion}/guias-remision."
      },
      "IFormFile": {
        "type": "string",
        "format": "binary"
      },
      "ImpuestoDocSustentoDto": {
        "required": [
          "codImpuestoDocSustento",
          "codigoPorcentaje",
          "baseImponible",
          "tarifa",
          "valorImpuesto"
        ],
        "type": "object",
        "properties": {
          "codImpuestoDocSustento": {
            "examples": [
              "2"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del impuesto del sustento (2 IVA, 3 ICE, 5 IRBPNR)."
          },
          "codigoPorcentaje": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del porcentaje del impuesto del sustento."
          },
          "baseImponible": {
            "type": [
              "null",
              "number"
            ],
            "description": "Base imponible del impuesto del sustento.",
            "format": "double"
          },
          "tarifa": {
            "type": [
              "null",
              "number"
            ],
            "description": "Tarifa del impuesto del sustento.",
            "format": "double"
          },
          "valorImpuesto": {
            "examples": [
              15.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Valor del impuesto del sustento.",
            "format": "double"
          }
        },
        "description": "Impuesto declarado en un documento de sustento de retencion."
      },
      "ImpuestoDto": {
        "required": [
          "codigo",
          "codigoPorcentaje",
          "baseImponible",
          "valor"
        ],
        "type": "object",
        "properties": {
          "codigo": {
            "examples": [
              "2"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del impuesto: 2 IVA, 3 ICE, 5 IRBPNR."
          },
          "codigoPorcentaje": {
            "examples": [
              "4"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del porcentaje o tarifa del impuesto segun el catalogo del SRI."
          },
          "tarifa": {
            "examples": [
              15.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Tarifa del impuesto en tanto por ciento. En el detalle es obligatoria; en cabecera es opcional.",
            "format": "double"
          },
          "baseImponible": {
            "examples": [
              100.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Base imponible sobre la que se calcula el impuesto.",
            "format": "double"
          },
          "valor": {
            "examples": [
              15.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Valor del impuesto.",
            "format": "double"
          }
        },
        "description": "Impuesto declarado sobre un detalle o en el total de impuestos del comprobante."
      },
      "InfoComprobanteRetencionDto": {
        "required": [
          "fechaEmision",
          "tipoIdentificacionSujetoRetenido",
          "razonSocialSujetoRetenido",
          "identificacionSujetoRetenido",
          "periodoFiscal",
          "parteRel"
        ],
        "type": "object",
        "properties": {
          "fechaEmision": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision en formato dd/MM/yyyy."
          },
          "tipoIdentificacionSujetoRetenido": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de identificacion del sujeto retenido."
          },
          "razonSocialSujetoRetenido": {
            "examples": [
              "Proveedor de prueba"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Razon social del sujeto al que se retiene."
          },
          "identificacionSujetoRetenido": {
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de identificacion del sujeto retenido."
          },
          "periodoFiscal": {
            "examples": [
              "11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Periodo fiscal al que corresponde la retencion, en formato MM/yyyy."
          },
          "parteRel": {
            "examples": [
              "NO"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Indica si la operacion es entre partes relacionadas (SI o NO)."
          },
          "tipoSujetoRetenido": {
            "type": [
              "null",
              "string"
            ],
            "description": "Clasifica al sujeto retenido cuando la normativa lo exige (opcional)."
          },
          "dirEstablecimiento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del establecimiento que emite el comprobante. Si se omite se entiende la direccion\r\nmatriz del emisor."
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telefono del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          },
          "correo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Correo del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          }
        },
        "description": "Contenido propio de un comprobante de retencion."
      },
      "InfoFacturaDto": {
        "required": [
          "fechaEmision",
          "tipoIdentificacionComprador",
          "razonSocialComprador",
          "identificacionComprador",
          "totalSinImpuestos",
          "moneda",
          "propina",
          "totalDescuento",
          "totalConImpuestos",
          "importeTotal",
          "pagos"
        ],
        "type": "object",
        "properties": {
          "fechaEmision": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision en formato dd/MM/yyyy. Debe coincidir con la fecha de la clave de acceso."
          },
          "tipoIdentificacionComprador": {
            "examples": [
              "05"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de identificacion del comprador (04 RUC, 05 cedula, 06 pasaporte, 07 consumidor final, 08 exterior)."
          },
          "razonSocialComprador": {
            "examples": [
              "Cliente de prueba"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Razon social o nombre del comprador."
          },
          "identificacionComprador": {
            "examples": [
              "0123456789"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de identificacion del comprador."
          },
          "direccionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del comprador, cuando se conoce."
          },
          "totalSinImpuestos": {
            "examples": [
              100.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la operacion sin impuestos ni propina. Lo declara el emisor.",
            "format": "double"
          },
          "moneda": {
            "examples": [
              "DOLAR"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Moneda del comprobante: DOLAR o USD."
          },
          "totalDescuento": {
            "examples": [
              0.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Total de descuentos aplicados antes de impuestos.",
            "format": "double"
          },
          "totalConImpuestos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDto"
            },
            "description": "Impuestos totales del documento agrupados por impuesto y porcentaje."
          },
          "importeTotal": {
            "examples": [
              115.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Importe total del comprobante (subtotal mas impuestos mas propina).",
            "format": "double"
          },
          "propina": {
            "type": [
              "null",
              "number"
            ],
            "description": "Propina informativa incluida en la factura; no forma parte de la base del IVA.",
            "format": "double"
          },
          "pagos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PagoDto"
            },
            "description": "Formas de pago del documento."
          },
          "guiaRemision": {
            "examples": [
              "001-001-000000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de la guia de remision asociada, con formato 000-000-000000000."
          },
          "placa": {
            "examples": [
              "ABC1234"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de placa del vehiculo cuando la operacion lo exige."
          },
          "comercioExterior": {
            "examples": [
              "EXPORTADOR"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Valor fijo EXPORTADOR cuando la factura corresponde a comercio exterior."
          },
          "incoTermFactura": {
            "type": [
              "null",
              "string"
            ],
            "description": "Termino de negociacion internacional (Incoterm) de la factura de exportacion."
          },
          "lugarIncoTerm": {
            "type": [
              "null",
              "string"
            ],
            "description": "Lugar pactado para la entrega segun el Incoterm."
          },
          "paisOrigen": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del pais de origen de la mercaderia."
          },
          "puertoEmbarque": {
            "type": [
              "null",
              "string"
            ],
            "description": "Puerto de embarque de la mercaderia."
          },
          "puertoDestino": {
            "type": [
              "null",
              "string"
            ],
            "description": "Puerto de destino de la mercaderia."
          },
          "paisDestino": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del pais de destino de la mercaderia."
          },
          "paisAdquisicion": {
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del pais donde el importador adquirio la mercaderia."
          },
          "incoTermTotalSinImpuestos": {
            "type": [
              "null",
              "string"
            ],
            "description": "Incoterm aplicado sobre el total sin impuestos, cuando difiere del de los precios unitarios."
          },
          "dirEstablecimiento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del establecimiento que emite el comprobante. Si se omite se entiende la direccion\r\nmatriz del emisor."
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telefono del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          },
          "correo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Correo del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          }
        },
        "description": "Contenido propio de una factura."
      },
      "InfoGuiaRemisionDto": {
        "required": [
          "dirPartida",
          "razonSocialTransportista",
          "tipoIdentificacionTransportista",
          "rucTransportista",
          "fechaIniTransporte",
          "fechaFinTransporte",
          "placa"
        ],
        "type": "object",
        "properties": {
          "dirPartida": {
            "examples": [
              "Av. Amazonas 123, Quito"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion de origen del traslado."
          },
          "razonSocialTransportista": {
            "examples": [
              "Transportes Andinos"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Nombre o razon social del transportista."
          },
          "tipoIdentificacionTransportista": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de identificacion del transportista."
          },
          "rucTransportista": {
            "examples": [
              "1790012345001"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "RUC del transportista."
          },
          "fechaIniTransporte": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de inicio del traslado en formato dd/MM/yyyy."
          },
          "fechaFinTransporte": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de fin del traslado en formato dd/MM/yyyy."
          },
          "placa": {
            "examples": [
              "ABC1234"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de placa del vehiculo que realiza el traslado."
          },
          "dirEstablecimiento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del establecimiento que emite el comprobante. Si se omite se entiende la direccion\r\nmatriz del emisor."
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telefono del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          },
          "correo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Correo del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          }
        },
        "description": "Contenido propio de una guia de remision."
      },
      "InfoLiquidacionCompraDto": {
        "required": [
          "fechaEmision",
          "tipoIdentificacionProveedor",
          "razonSocialProveedor",
          "identificacionProveedor",
          "totalSinImpuestos",
          "moneda",
          "totalDescuento",
          "totalConImpuestos",
          "importeTotal",
          "pagos"
        ],
        "type": "object",
        "properties": {
          "fechaEmision": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision en formato dd/MM/yyyy."
          },
          "tipoIdentificacionProveedor": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de identificacion del proveedor (04 RUC, 05 cedula, 06 pasaporte, 08 exterior)."
          },
          "razonSocialProveedor": {
            "examples": [
              "Proveedor de prueba"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Razon social o nombre del proveedor."
          },
          "identificacionProveedor": {
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de identificacion del proveedor."
          },
          "direccionProveedor": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del proveedor, cuando se desea incluir."
          },
          "totalSinImpuestos": {
            "examples": [
              100.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la operacion sin impuestos. Lo declara el emisor.",
            "format": "double"
          },
          "moneda": {
            "type": [
              "null",
              "string"
            ],
            "description": "Moneda del comprobante: DOLAR o USD."
          },
          "totalDescuento": {
            "type": [
              "null",
              "number"
            ],
            "description": "Total de descuentos aplicados antes de impuestos.",
            "format": "double"
          },
          "totalConImpuestos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDto"
            },
            "description": "Impuestos totales del documento agrupados por impuesto y porcentaje."
          },
          "importeTotal": {
            "examples": [
              115.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Importe total del comprobante.",
            "format": "double"
          },
          "pagos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PagoDto"
            },
            "description": "Formas de pago del documento."
          },
          "dirEstablecimiento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del establecimiento que emite el comprobante. Si se omite se entiende la direccion\r\nmatriz del emisor."
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telefono del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          },
          "correo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Correo del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          }
        },
        "description": "Contenido propio de una liquidacion de compra."
      },
      "InfoNotaCreditoDto": {
        "required": [
          "fechaEmision",
          "tipoIdentificacionComprador",
          "razonSocialComprador",
          "identificacionComprador",
          "totalSinImpuestos",
          "moneda",
          "totalConImpuestos",
          "valorModificacion",
          "codDocModificado",
          "numDocModificado",
          "fechaEmisionDocSustento",
          "motivo"
        ],
        "type": "object",
        "properties": {
          "fechaEmision": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision en formato dd/MM/yyyy."
          },
          "tipoIdentificacionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de identificacion del comprador."
          },
          "razonSocialComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Razon social o nombre del comprador."
          },
          "identificacionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de identificacion del comprador."
          },
          "direccionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del comprador, cuando se conoce."
          },
          "totalSinImpuestos": {
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la operacion sin impuestos.",
            "format": "double"
          },
          "moneda": {
            "type": [
              "null",
              "string"
            ],
            "description": "Moneda del comprobante: DOLAR o USD."
          },
          "totalConImpuestos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDto"
            },
            "description": "Impuestos totales del documento agrupados por impuesto y porcentaje."
          },
          "valorModificacion": {
            "examples": [
              115.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Valor de la modificacion: el monto que se acredita al comprador.",
            "format": "double"
          },
          "codDocModificado": {
            "examples": [
              "01"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de comprobante que modifica la nota de credito."
          },
          "numDocModificado": {
            "examples": [
              "001-001-000000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero del documento modificado con formato 000-000-000000000."
          },
          "fechaEmisionDocSustento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision del documento que se esta modificando."
          },
          "totalDocumentoSustento": {
            "type": [
              "null",
              "number"
            ],
            "description": "Total del documento que acredita la nota de credito; opcional.",
            "format": "double"
          },
          "motivo": {
            "examples": [
              "Devolucion de mercaderia"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Motivo de la nota de credito: describe la razon del ajuste."
          },
          "dirEstablecimiento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del establecimiento que emite el comprobante. Si se omite se entiende la direccion\r\nmatriz del emisor."
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telefono del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          },
          "correo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Correo del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          }
        },
        "description": "Contenido propio de una nota de credito."
      },
      "InfoNotaDebitoDto": {
        "required": [
          "fechaEmision",
          "tipoIdentificacionComprador",
          "razonSocialComprador",
          "identificacionComprador",
          "codDocModificado",
          "numDocModificado",
          "fechaEmisionDocSustento",
          "totalSinImpuestos",
          "valorTotal",
          "impuestos",
          "pagos"
        ],
        "type": "object",
        "properties": {
          "fechaEmision": {
            "examples": [
              "12/11/2026"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision en formato dd/MM/yyyy."
          },
          "tipoIdentificacionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de identificacion del comprador."
          },
          "razonSocialComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Razon social o nombre del comprador."
          },
          "identificacionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Numero de identificacion del comprador."
          },
          "direccionComprador": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del comprador, cuando se conoce."
          },
          "totalSinImpuestos": {
            "type": [
              "null",
              "number"
            ],
            "description": "Total de la operacion sin impuestos.",
            "format": "double"
          },
          "moneda": {
            "type": [
              "null",
              "string"
            ],
            "description": "Moneda del comprobante: DOLAR o USD."
          },
          "codDocModificado": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de comprobante que modifica la nota de debito."
          },
          "numDocModificado": {
            "examples": [
              "001-001-000000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero del documento modificado con formato 000-000-000000000."
          },
          "fechaEmisionDocSustento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha de emision del documento que se esta modificando."
          },
          "valorTotal": {
            "examples": [
              115.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Valor total debitado, incluidos impuestos.",
            "format": "double"
          },
          "impuestos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ImpuestoDto"
            },
            "description": "Impuestos de cabecera de la nota de debito (obligatorio)."
          },
          "pagos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PagoDto"
            },
            "description": "Formas de pago del documento."
          },
          "dirEstablecimiento": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion del establecimiento que emite el comprobante. Si se omite se entiende la direccion\r\nmatriz del emisor."
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telefono del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          },
          "correo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Correo del comprador o receptor. La plataforma lo usa para el envio del comprobante."
          }
        },
        "description": "Contenido propio de una nota de debito."
      },
      "InfoTributariaDto": {
        "required": [
          "ruc",
          "estab",
          "ptoEmi"
        ],
        "type": "object",
        "properties": {
          "ruc": {
            "examples": [
              "0921357232001"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "RUC del emisor (13 digitos). La plataforma lo valida contra el contribuyente autorizado del\r\ncontexto."
          },
          "razonSocial": {
            "type": [
              "null",
              "string"
            ],
            "description": "Razon social del emisor para este documento, hasta 300 caracteres. Si se omite, se usa la referencia configurada."
          },
          "nombreComercial": {
            "type": [
              "null",
              "string"
            ],
            "description": "Nombre comercial del emisor para este documento, hasta 300 caracteres."
          },
          "dirMatriz": {
            "type": [
              "null",
              "string"
            ],
            "description": "Direccion de la matriz, hasta 300 caracteres. Debe enviarse si el emisor no tiene una direccion configurada."
          },
          "estab": {
            "examples": [
              "001"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero del establecimiento emisor (3 digitos), parte de la serie del documento."
          },
          "ptoEmi": {
            "examples": [
              "001"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero del punto de emision (3 digitos), parte de la serie del documento."
          },
          "secuencial": {
            "examples": [
              "000000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Secuencial del documento (9 digitos). Con la serie forma el numero del comprobante. Si se\r\nomite o va en ceros, la plataforma asigna el siguiente de la serie."
          }
        },
        "description": "Informacion tributaria comun del comprobante: identifica al emisor y la identidad fiscal\r\n(serie y secuencial). El tipo de documento lo fija la ruta del endpoint, no el cuerpo."
      },
      "LiquidacionCompraRequestDto": {
        "required": [
          "origenReferencia",
          "referenciaExterna",
          "infoTributaria",
          "info",
          "detalles"
        ],
        "type": "object",
        "properties": {
          "info": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Informacion de la liquidacion: proveedor, totales y pagos.",
                "$ref": "#/components/schemas/InfoLiquidacionCompraDto"
              }
            ]
          },
          "detalles": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DetalleCompraVentaDto"
            },
            "description": "Lineas de detalle de la liquidacion."
          },
          "origenReferencia": {
            "examples": [
              "mi-erp"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador del sistema o producto que origina el comprobante; se usa como espacio de\r\nreferencia para la idempotencia del envio."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia empresarial propia del emisor para el comprobante; debe ser estable en reintentos\r\npara no duplicar emisiones."
          },
          "infoTributaria": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Datos tributarios comunes de todo comprobante: RUC del emisor, serie y secuencial.",
                "$ref": "#/components/schemas/InfoTributariaDto"
              }
            ]
          },
          "infoAdicional": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Informacion adicional libre del comprobante como pares nombre/valor; el SRI la usa para\r\nanexos obligatorios (por ejemplo, el RUC del proveedor de software)."
          }
        },
        "description": "Liquidacion de compra (codigo 03). Contrato de entrada del endpoint\r\n/v1/contribuyentes/{identificacion}/liquidaciones-compra."
      },
      "MotivoDto": {
        "required": [
          "razon",
          "valor"
        ],
        "type": "object",
        "properties": {
          "razon": {
            "examples": [
              "Interes por mora"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Descripcion de la razon por la que se debita."
          },
          "valor": {
            "examples": [
              15.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Valor debitado por este motivo.",
            "format": "double"
          }
        },
        "description": "Motivo de una nota de debito: describe la razon del debito y el valor asociado."
      },
      "NotaCreditoRequestDto": {
        "required": [
          "origenReferencia",
          "referenciaExterna",
          "infoTributaria",
          "info",
          "detalles"
        ],
        "type": "object",
        "properties": {
          "info": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Informacion de la nota de credito: comprador, documento modificado y motivo.",
                "$ref": "#/components/schemas/InfoNotaCreditoDto"
              }
            ]
          },
          "detalles": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DetalleNotaCreditoDto"
            },
            "description": "Lineas de detalle de la nota de credito."
          },
          "origenReferencia": {
            "examples": [
              "mi-erp"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador del sistema o producto que origina el comprobante; se usa como espacio de\r\nreferencia para la idempotencia del envio."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia empresarial propia del emisor para el comprobante; debe ser estable en reintentos\r\npara no duplicar emisiones."
          },
          "infoTributaria": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Datos tributarios comunes de todo comprobante: RUC del emisor, serie y secuencial.",
                "$ref": "#/components/schemas/InfoTributariaDto"
              }
            ]
          },
          "infoAdicional": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Informacion adicional libre del comprobante como pares nombre/valor; el SRI la usa para\r\nanexos obligatorios (por ejemplo, el RUC del proveedor de software)."
          }
        },
        "description": "Nota de credito (codigo 04). Contrato de entrada del endpoint\r\n/v1/contribuyentes/{identificacion}/notas-credito."
      },
      "NotaDebitoRequestDto": {
        "required": [
          "origenReferencia",
          "referenciaExterna",
          "infoTributaria",
          "info",
          "motivos"
        ],
        "type": "object",
        "properties": {
          "info": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Informacion de la nota de debito: comprador, documento modificado, impuestos y total.",
                "$ref": "#/components/schemas/InfoNotaDebitoDto"
              }
            ]
          },
          "motivos": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/MotivoDto"
            },
            "description": "Motivos de la nota de debito, cada uno con su razon y el valor que se debita."
          },
          "origenReferencia": {
            "examples": [
              "mi-erp"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador del sistema o producto que origina el comprobante; se usa como espacio de\r\nreferencia para la idempotencia del envio."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia empresarial propia del emisor para el comprobante; debe ser estable en reintentos\r\npara no duplicar emisiones."
          },
          "infoTributaria": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Datos tributarios comunes de todo comprobante: RUC del emisor, serie y secuencial.",
                "$ref": "#/components/schemas/InfoTributariaDto"
              }
            ]
          },
          "infoAdicional": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CampoAdicionalDto"
            },
            "description": "Informacion adicional libre del comprobante como pares nombre/valor; el SRI la usa para\r\nanexos obligatorios (por ejemplo, el RUC del proveedor de software)."
          }
        },
        "description": "Nota de debito (codigo 05). Contrato de entrada del endpoint\r\n/v1/contribuyentes/{identificacion}/notas-debito."
      },
      "OperationDto": {
        "required": [
          "estado",
          "codEstado",
          "errores",
          "idOperacion",
          "urlEstado",
          "ambiente",
          "tipoDocumento",
          "numeroDocumento",
          "referenciaExterna",
          "claveAcceso",
          "fhRecibido",
          "fhAutorizacion"
        ],
        "type": "object",
        "properties": {
          "estado": {
            "$ref": "#/components/schemas/EstadoPublico"
          },
          "codEstado": {
            "$ref": "#/components/schemas/CodEstado"
          },
          "msgError": {
            "examples": [
              "El comprobante no cumple las validaciones."
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Mensaje fijo del codEstado; se omite cuando no hay error."
          },
          "errores": {
            "examples": [
              [
                "$.info.importeTotal: El importe no coincide con los totales."
              ]
            ],
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Detalle de la validacion o del SRI; lista vacia si no hay detalle."
          },
          "idOperacion": {
            "examples": [
              "3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Identificador de la operacion; null en un rechazo sincronico.",
            "format": "uuid"
          },
          "urlEstado": {
            "examples": [
              "https://api-sandbox.mynexusapi.com/v1/operaciones/3f2b8c1e-5a47-4d0e-9b61-0c7d2e8f1a90"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "URL absoluta del seguimiento de la operacion."
          },
          "ambiente": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Ambiente fiscal de la operacion: 1 pruebas, 2 produccion.",
                "examples": [
                  1
                ],
                "$ref": "#/components/schemas/FiscalEnvironment"
              }
            ]
          },
          "tipoDocumento": {
            "examples": [
              "01"
            ],
            "enum": [
              "01",
              "03",
              "04",
              "05",
              "06",
              "07"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Tipo de comprobante: 01, 03, 04, 05, 06 o 07."
          },
          "numeroDocumento": {
            "examples": [
              "001-001-000000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Numero del comprobante estab-ptoEmi-secuencial."
          },
          "referenciaExterna": {
            "examples": [
              "FAC-2026-000123"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Referencia estable enviada por el integrador."
          },
          "claveAcceso": {
            "examples": [
              "1211202601179999999900110010010000001231234567812"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Clave de acceso de 49 digitos; null mientras no exista."
          },
          "fhRecibido": {
            "examples": [
              "2026-11-12T10:15:00-05:00"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha y hora de recepcion en Ecuador (-05:00).",
            "format": "date-time"
          },
          "fhAutorizacion": {
            "examples": [
              "2026-11-12T10:16:00-05:00"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Fecha y hora de autorizacion del SRI, si existe.",
            "format": "date-time"
          }
        },
        "description": "Forma unica de la emision y el seguimiento: la respuesta 202 de POST .../comprobantes, sus rechazos sincronicos\r\n(4xx/5xx) y GET /v1/operaciones/{idOperacion}. Todos los campos se serializan aunque sean null, para que la forma\r\nsea estable; solo msgError se omite cuando no hay error."
      },
      "PaginaComprobantesDto": {
        "required": [
          "comprobantes",
          "pagina",
          "tamanoPagina",
          "hayMas"
        ],
        "type": "object",
        "properties": {
          "comprobantes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ComprobanteDto"
            }
          },
          "pagina": {
            "type": "integer",
            "format": "int32"
          },
          "tamanoPagina": {
            "type": "integer",
            "format": "int32"
          },
          "hayMas": {
            "type": "boolean"
          }
        }
      },
      "PagoDto": {
        "required": [
          "formaPago",
          "total"
        ],
        "type": "object",
        "properties": {
          "formaPago": {
            "examples": [
              "01"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo de la forma de pago segun el catalogo del SRI."
          },
          "total": {
            "examples": [
              115.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Monto pagado con esa forma de pago.",
            "format": "double"
          },
          "plazo": {
            "examples": [
              30.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Plazo de pago en la unidad indicada; si es cero no aplica.",
            "format": "double"
          },
          "unidadTiempo": {
            "examples": [
              "dias"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Unidad de tiempo del plazo (por ejemplo, dias o meses)."
          }
        },
        "description": "Forma de pago del comprobante con su codigo, el total pagado, el plazo y la unidad de tiempo."
      },
      "PerfilEmisorDto": {
        "required": [
          "identificacion",
          "razonSocial",
          "nombreComercial",
          "direccionMatriz",
          "direccionEstablecimiento",
          "codigoEstablecimiento",
          "codigoPuntoEmision",
          "moneda",
          "obligadoContabilidad",
          "correo",
          "telefono",
          "ciudad",
          "provincia",
          "pais",
          "logo"
        ],
        "type": "object",
        "properties": {
          "identificacion": {
            "type": "string"
          },
          "razonSocial": {
            "type": "string"
          },
          "nombreComercial": {
            "type": [
              "null",
              "string"
            ]
          },
          "direccionMatriz": {
            "type": [
              "null",
              "string"
            ]
          },
          "direccionEstablecimiento": {
            "type": [
              "null",
              "string"
            ]
          },
          "codigoEstablecimiento": {
            "type": [
              "null",
              "string"
            ]
          },
          "codigoPuntoEmision": {
            "type": [
              "null",
              "string"
            ]
          },
          "moneda": {
            "type": [
              "null",
              "string"
            ]
          },
          "obligadoContabilidad": {
            "type": "boolean"
          },
          "correo": {
            "type": [
              "null",
              "string"
            ]
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ]
          },
          "ciudad": {
            "type": [
              "null",
              "string"
            ]
          },
          "provincia": {
            "type": [
              "null",
              "string"
            ]
          },
          "pais": {
            "type": [
              "null",
              "string"
            ]
          },
          "logo": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "PerfilEmisorUpdateDto": {
        "type": "object",
        "properties": {
          "nombreComercial": {
            "type": [
              "null",
              "string"
            ]
          },
          "direccionMatriz": {
            "type": [
              "null",
              "string"
            ]
          },
          "correo": {
            "type": [
              "null",
              "string"
            ]
          },
          "telefono": {
            "type": [
              "null",
              "string"
            ]
          },
          "ciudad": {
            "type": [
              "null",
              "string"
            ]
          },
          "provincia": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "QuotaBucketDto": {
        "required": [
          "limiteDocumentos",
          "reservados",
          "consumidos",
          "disponibles",
          "vigenteHasta",
          "limiteExtra",
          "reservadosExtra",
          "consumidosExtra",
          "disponiblesExtra"
        ],
        "type": "object",
        "properties": {
          "limiteDocumentos": {
            "type": "integer",
            "format": "int32"
          },
          "reservados": {
            "type": "integer",
            "format": "int32"
          },
          "consumidos": {
            "type": "integer",
            "format": "int32"
          },
          "disponibles": {
            "type": "integer",
            "format": "int32"
          },
          "vigenteHasta": {
            "type": "string",
            "format": "date-time"
          },
          "limiteExtra": {
            "type": "integer",
            "format": "int32"
          },
          "reservadosExtra": {
            "type": "integer",
            "format": "int32"
          },
          "consumidosExtra": {
            "type": "integer",
            "format": "int32"
          },
          "disponiblesExtra": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "RepresentanteLegalDto": {
        "required": [
          "identificacion",
          "nombre"
        ],
        "type": "object",
        "properties": {
          "identificacion": {
            "type": [
              "null",
              "string"
            ]
          },
          "nombre": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "RetencionLineaDto": {
        "required": [
          "codigo",
          "codigoRetencion",
          "baseImponible",
          "porcentajeRetener",
          "valorRetenido"
        ],
        "type": "object",
        "properties": {
          "codigo": {
            "examples": [
              "1"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo del impuesto retenido (renta, IVA u otros segun el catalogo)."
          },
          "codigoRetencion": {
            "examples": [
              "312"
            ],
            "type": [
              "null",
              "string"
            ],
            "description": "Codigo especifico de la retencion dentro del impuesto."
          },
          "baseImponible": {
            "type": [
              "null",
              "number"
            ],
            "description": "Base sobre la que se calcula la retencion.",
            "format": "double"
          },
          "porcentajeRetener": {
            "examples": [
              1.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Porcentaje de retencion aplicado.",
            "format": "double"
          },
          "valorRetenido": {
            "examples": [
              1.00
            ],
            "type": [
              "null",
              "number"
            ],
            "description": "Valor retenido.",
            "format": "double"
          }
        },
        "description": "Linea de retencion practicada sobre un sustento, con el codigo, la base y el valor retenido."
      },
      "ValidacionComprobanteDto": {
        "required": [
          "valido",
          "errores"
        ],
        "type": "object",
        "properties": {
          "valido": {
            "type": "boolean"
          },
          "errores": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "advertencias": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "description": "Respuesta 200 de POST .../comprobantes/validar cuando el comprobante cumple todas las reglas de la emision:\r\n{\"valido\": true, \"errores\": []}. Si no cumple, responde 422 con el mismo sobre de error que la emision."
      },
      "ValidacionIdentificacionDto": {
        "required": [
          "entrada",
          "normalizado",
          "valido",
          "tipo",
          "longitud",
          "esSoloDigitos",
          "cedulaBaseDelRuc",
          "mensaje"
        ],
        "type": "object",
        "properties": {
          "entrada": {
            "type": [
              "null",
              "string"
            ]
          },
          "normalizado": {
            "type": [
              "null",
              "string"
            ]
          },
          "valido": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "tipo": {
            "type": [
              "null",
              "string"
            ]
          },
          "longitud": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "esSoloDigitos": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "cedulaBaseDelRuc": {
            "type": [
              "null",
              "string"
            ]
          },
          "mensaje": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "WebhookDeliveryAttemptDto": {
        "required": [
          "intento",
          "fecha",
          "httpStatus",
          "codigoError",
          "duracionMs",
          "resultado"
        ],
        "type": "object",
        "properties": {
          "intento": {
            "type": "integer",
            "format": "int32"
          },
          "fecha": {
            "type": "string",
            "format": "date-time"
          },
          "httpStatus": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int16"
          },
          "codigoError": {
            "type": [
              "null",
              "string"
            ]
          },
          "duracionMs": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "resultado": {
            "type": "string"
          }
        }
      },
      "WebhookDeliveryDto": {
        "required": [
          "publicId",
          "eventId",
          "intento",
          "estado",
          "programado",
          "enviado",
          "httpStatus",
          "codigoError",
          "tipoEvento"
        ],
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "format": "uuid"
          },
          "eventId": {
            "type": "string",
            "format": "uuid"
          },
          "intento": {
            "type": "integer",
            "format": "int32"
          },
          "estado": {
            "type": "string"
          },
          "programado": {
            "type": "string",
            "format": "date-time"
          },
          "enviado": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "httpStatus": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int16"
          },
          "codigoError": {
            "type": [
              "null",
              "string"
            ]
          },
          "tipoEvento": {
            "type": "string"
          }
        }
      },
      "WebhookDestinoCrearRequest": {
        "required": [
          "url",
          "eventos"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "eventos": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ruc": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "WebhookDestinoEventosRequest": {
        "required": [
          "eventos"
        ],
        "type": "object",
        "properties": {
          "eventos": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "WebhookEndpointCreatedDto": {
        "required": [
          "publicId",
          "url",
          "secretoUnaVez"
        ],
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string"
          },
          "secretoUnaVez": {
            "type": "string"
          },
          "ruc": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "WebhookEndpointDto": {
        "required": [
          "publicId",
          "url",
          "state",
          "fallosConsecutivos",
          "ultimoFallo",
          "creado",
          "eventos"
        ],
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "format": "uuid"
          },
          "url": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "fallosConsecutivos": {
            "type": "integer",
            "format": "int32"
          },
          "ultimoFallo": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "creado": {
            "type": "string",
            "format": "date-time"
          },
          "eventos": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ruc": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      }
    },
    "headers": {
      "X-Correlation-Id": {
        "description": "Identificador de correlacion de la peticion. Envia este valor a soporte.",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "X-Api-Version": {
        "description": "Version del contrato con la que respondio la API.",
        "required": true,
        "schema": {
          "type": "string",
          "format": "date"
        }
      },
      "Location": {
        "description": "URL absoluta para seguir la operacion. Es la misma de urlEstado.",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uri"
        }
      },
      "Retry-After": {
        "description": "Segundos que conviene esperar antes de reintentar.",
        "required": true,
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      },
      "X-RateLimit-Limit": {
        "description": "Limite de solicitudes por minuto aplicado a la credencial. Puede no estar presente si el limitador no aplica.",
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      },
      "X-RateLimit-Remaining": {
        "description": "Solicitudes disponibles en la ventana actual. Puede no estar presente si el limitador no aplica.",
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      },
      "X-RateLimit-Reset": {
        "description": "Momento (epoch en segundos) en que se repone la ventana del limitador.",
        "schema": {
          "type": "integer",
          "format": "int64"
        }
      }
    },
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "description": "API Key de la integracion (cabecera X-Api-Key).",
        "name": "X-Api-Key",
        "in": "header"
      }
    }
  },
  "tags": [
    {
      "name": "Salud"
    },
    {
      "name": "Catalogos"
    },
    {
      "name": "Contexto"
    },
    {
      "name": "Consultas SRI"
    },
    {
      "name": "Descargas"
    },
    {
      "name": "Seguimiento"
    },
    {
      "name": "Consumo"
    },
    {
      "name": "Emisión"
    },
    {
      "name": "Perfil"
    },
    {
      "name": "Validación"
    },
    {
      "name": "Webhooks"
    }
  ]
}