Descargar el XML fiscal firmado

GET

/v1/taxpayers/{taxpayer_id}/fiscal-documents/{document_id}/xml

curl --request GET \
  --url https://sandbox.api.cierrelisto.com/v1/taxpayers/340f4500-e627-4f37-aaa8-9ad5baff8209/fiscal-documents/261aa475-f462-4446-9f88-9525714ed925/xml \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Request-Id: req_6a07a2bfa55e4e1ebf5a9f27482f09f1'

• Sandbox aislado, sin efectos fiscales reales.
• Precertificación para preparar y verificar integraciones antes del flujo formal de certificación.
• Certificación para ejecutar los casos y validaciones correspondientes al proceso del contribuyente.
• Producción DGII.

Requiere el alcance ecf.read. Devuelve los bytes inmutables del XML fiscal firmado.

Authorizations

• BearerAuth

Parameters

Path Parameters

taxpayer_id

required

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

Contribuyente autorizado dentro de la cuenta CierreListo.

Example

340f4500-e627-4f37-aaa8-9ad5baff8209

document_id

required

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

Example

261aa475-f462-4446-9f88-9525714ed925

Header Parameters

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador opcional del cliente. Si no es válido, CierreListo genera uno.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

Responses

200

XML fiscal firmado.

Media typeapplication/xml

string format: binary

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

401

Credencial ausente o inválida.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "unauthorized",
    "message": "La credencial no es válida.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

403

La credencial no autoriza esta operación, integración o ambiente.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "forbidden",
    "message": "La credencial no tiene el alcance requerido.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

404

El recurso no existe dentro del contribuyente autorizado.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "not_found",
    "message": "No se encontró el recurso solicitado.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

409

El documento existe, pero el artefacto todavía no está disponible en este ambiente o estado.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "artifact_not_ready",
    "message": "El artefacto fiscal todavía no está disponible.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

429

Se excedió el límite temporal de solicitudes.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "rate_limited",
    "message": "Espera antes de volver a intentarlo.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

500

CierreListo no pudo completar la operación por un error interno.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "internal_error",
    "message": "No pudimos completar la operación. Conserva el request_id para soporte.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

503

El servicio no puede completar temporalmente la operación.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: bad_request invalid_json validation_error unauthorized forbidden not_found idempotency_mismatch external_id_conflict operational_readiness_failed artifact_not_ready rate_limited service_unavailable internal_error

message

required

string

>= 1 characters

request_id

required

string

/^req_[0-9a-f]{32}$/

details

Array<object>

object

field

required

string

>= 1 characters

code

required

string

>= 1 characters

message

required

string

>= 1 characters

key

additional properties

key

additional properties

key

additional properties

Example

{
  "error": {
    "code": "service_unavailable",
    "message": "El servicio no está disponible temporalmente.",
    "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1"
  }
}

Headers

X-Request-Id

string

/^req_[0-9a-f]{32}$/

Identificador de trazabilidad de la solicitud.

Example

req_6a07a2bfa55e4e1ebf5a9f27482f09f1

RateLimit-Limit

integer

>= 1

Máximo de solicitudes permitidas en la ventana actual.

Example

70

RateLimit-Remaining

integer

Solicitudes disponibles antes de agotar la ventana actual.

Example

69

RateLimit-Reset

integer

Instante de reinicio de la ventana expresado como Unix time.

Example

1785337200

Retry-After

integer

>= 1

Segundos que debe esperar el cliente antes de reintentar una operación temporalmente ocupada.

Example

1