Ejecutar un archivo de pruebas de certificación

POST

/v1/business/certification/test-runs

curl --request POST \
  --url https://api.timbro.do/v1/business/certification/test-runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: example' \
  --data '{ "kind": "ecf", "testSetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "confirmation": { "statementVersion": "2026-10-21", "language": "es" } }'

• API de Timbro

Timbro firma cada caso del archivo de pruebas guardado (kind ecf para el paso 2 de la DGII, acecf para el paso 3) con el certificado de firma del negocio que Timbro custodia, y lo envía a la DGII en el orden del archivo, hasta el primer rechazo. Llámala solo mientras la certificación del negocio incluya la acción run_test_set; si no, responde business_certification_unavailable. El representante debe confirmar la declaración, y la confirmación se registra con el actor, la hora y el hash de la declaración antes de consultar a Timbro. Solo una persona o una clave de administrador puede confirmar, no un agente. Debe existir un archivo guardado de ese tipo; si no, responde business_certification_test_set_required. Si otro archivo más reciente reemplazó al que indica testSetId, responde business_certification_test_set_changed y no ejecuta nada. Un reintento con la misma clave de idempotencia (Idempotency-Key) y el mismo cuerpo devuelve la misma ejecución; una ejecución nueva requiere una confirmación y una clave nuevas. Una ejecución es evidencia para el negocio y para el equipo, no una decisión de la DGII: nunca cambia el estado de un paso. Consulta el resultado con retrieveBusinessCertificationTestRun.

Autenticación

• adminKey

Parámetros

Parámetros de cabecera

idempotency-key

obligatorio

string

>= 1 characters <= 255 characters /^[\x20-\x7e]+$/

Cuerpo de la solicitud^obligatorio

Media typeapplication/json

object

kind

obligatorio

Cualquiera de:

string

string

Valor permitido: ecf

string

string

Valor permitido: acecf

testSetId

obligatorio

El id del archivo guardado que vio el representante. Si un archivo más reciente de ese tipo lo reemplazó, la operación responde business_certification_test_set_changed y no ejecuta nada.

string format: uuid

confirmation

obligatorio

La declaración que el representante leyó y aceptó para este archivo. {business} es la razón social del negocio. Envía una clave de idempotencia (Idempotency-Key) nueva para cada confirmación. 2026-10-21, es: “Autorizo a Timbro a firmar con el certificado digital de {business} y a enviar a la DGII los casos de prueba de este archivo.” 2026-10-21, en: “I authorize Timbro to sign with {business}’s digital certificate and send the test cases in this file to DGII.”

object

statementVersion

obligatorio

Cualquiera de:

string

string

Valor permitido: 2026-10-21

language

obligatorio

Cualquiera de:

string

string

Valor permitido: es

string

string

Valor permitido: en

Respuestas

200

200

Una ejecución de un archivo de pruebas de la DGII que Timbro guardó. Timbro firma cada caso con el certificado que custodia para el negocio y lo envía a la DGII en el orden del archivo, hasta el primer rechazo. refused significa que no se pudieron construir los documentos del archivo y no se envió nada; refusal indica la hoja, la fila y la columna, nunca el texto de la celda. consumerInvoices lista las facturas de consumo firmadas (E32) que subes en el cuadro del paso 2 del portal de la DGII, y queda vacía para acecf. Una ejecución es evidencia, no una decisión de la DGII: nunca cambia el estado de un paso.

Media typeapplication/json

Campos y códigos de la respuesta

Una ejecución de un archivo de pruebas de la DGII que Timbro guardó. Timbro firma cada caso con el certificado que custodia para el negocio y lo envía a la DGII en el orden del archivo, hasta el primer rechazo. refused significa que no se pudieron construir los documentos del archivo y no se envió nada; refusal indica la hoja, la fila y la columna, nunca el texto de la celda. consumerInvoices lista las facturas de consumo firmadas (E32) que subes en el cuadro del paso 2 del portal de la DGII, y queda vacía para acecf. Una ejecución es evidencia, no una decisión de la DGII: nunca cambia el estado de un paso.

object

object

obligatorio

string

Valor permitido: certification_test_run

id

obligatorio

string format: uuid

attemptReference

obligatorio

string

>= 1 characters

kind

obligatorio

Cualquiera de:

string

string

Valor permitido: ecf

string

string

Valor permitido: acecf

testSetId

obligatorio

string format: uuid

status

obligatorio

Cualquiera de:

string

string

Valor permitido: running

string

string

Valor permitido: accepted

string

string

Valor permitido: rejected

string

string

Valor permitido: failed

string

string

Valor permitido: refused

failureMessage

obligatorio

Cualquiera de:

string

string

null

null

createdAt

obligatorio

string format: date-time

completedAt

obligatorio

Cualquiera de:

string

string format: date-time

null

null

counts

obligatorio

Array<object>

object

documentType

obligatorio

Un tipo de e-CF del 31 al 47, RFCE o ACECF.

string

total

obligatorio

integer

accepted

obligatorio

integer

rejected

obligatorio

integer

cases

obligatorio

Array<object>

object

sourceRow

obligatorio

La fila del archivo de la que salió el caso.

integer

>= 1

caseLabel

obligatorio

Cualquiera de:

string

string

null

null

documentType

obligatorio

string

eNcf

obligatorio

string

status

obligatorio

Cualquiera de:

string

string

Valor permitido: pending

string

string

Valor permitido: sent

string

string

Valor permitido: accepted

string

string

Valor permitido: rejected

string

string

Valor permitido: unknown

dgiiMessage

obligatorio

Cualquiera de:

string

string

null

El texto de la DGII para un caso rechazado; en los demás casos, null.

null

refusal

obligatorio

Cualquiera de:

object

object

code

obligatorio

string

sheet

obligatorio

Cualquiera de:

string

string

null

null

row

obligatorio

Cualquiera de:

integer

integer

>= 1

null

null

column

obligatorio

Cualquiera de:

integer

integer

>= 1

null

null

null

null

consumerInvoices

obligatorio

Array<object>

object

eNcf

obligatorio

string

sourceRow

obligatorio

integer

>= 1

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

Idempotent-Replayed

string

Valor permitido: true

true cuando esta respuesta repite el resultado guardado de una solicitud anterior con la misma clave de idempotencia (Idempotency-Key).

201

201

Una ejecución de un archivo de pruebas de la DGII que Timbro guardó. Timbro firma cada caso con el certificado que custodia para el negocio y lo envía a la DGII en el orden del archivo, hasta el primer rechazo. refused significa que no se pudieron construir los documentos del archivo y no se envió nada; refusal indica la hoja, la fila y la columna, nunca el texto de la celda. consumerInvoices lista las facturas de consumo firmadas (E32) que subes en el cuadro del paso 2 del portal de la DGII, y queda vacía para acecf. Una ejecución es evidencia, no una decisión de la DGII: nunca cambia el estado de un paso.

Media typeapplication/json

Campos y códigos de la respuesta

Una ejecución de un archivo de pruebas de la DGII que Timbro guardó. Timbro firma cada caso con el certificado que custodia para el negocio y lo envía a la DGII en el orden del archivo, hasta el primer rechazo. refused significa que no se pudieron construir los documentos del archivo y no se envió nada; refusal indica la hoja, la fila y la columna, nunca el texto de la celda. consumerInvoices lista las facturas de consumo firmadas (E32) que subes en el cuadro del paso 2 del portal de la DGII, y queda vacía para acecf. Una ejecución es evidencia, no una decisión de la DGII: nunca cambia el estado de un paso.

object

object

obligatorio

string

Valor permitido: certification_test_run

id

obligatorio

string format: uuid

attemptReference

obligatorio

string

>= 1 characters

kind

obligatorio

Cualquiera de:

string

string

Valor permitido: ecf

string

string

Valor permitido: acecf

testSetId

obligatorio

string format: uuid

status

obligatorio

Cualquiera de:

string

string

Valor permitido: running

string

string

Valor permitido: accepted

string

string

Valor permitido: rejected

string

string

Valor permitido: failed

string

string

Valor permitido: refused

failureMessage

obligatorio

Cualquiera de:

string

string

null

null

createdAt

obligatorio

string format: date-time

completedAt

obligatorio

Cualquiera de:

string

string format: date-time

null

null

counts

obligatorio

Array<object>

object

documentType

obligatorio

Un tipo de e-CF del 31 al 47, RFCE o ACECF.

string

total

obligatorio

integer

accepted

obligatorio

integer

rejected

obligatorio

integer

cases

obligatorio

Array<object>

object

sourceRow

obligatorio

La fila del archivo de la que salió el caso.

integer

>= 1

caseLabel

obligatorio

Cualquiera de:

string

string

null

null

documentType

obligatorio

string

eNcf

obligatorio

string

status

obligatorio

Cualquiera de:

string

string

Valor permitido: pending

string

string

Valor permitido: sent

string

string

Valor permitido: accepted

string

string

Valor permitido: rejected

string

string

Valor permitido: unknown

dgiiMessage

obligatorio

Cualquiera de:

string

string

null

El texto de la DGII para un caso rechazado; en los demás casos, null.

null

refusal

obligatorio

Cualquiera de:

object

object

code

obligatorio

string

sheet

obligatorio

Cualquiera de:

string

string

null

null

row

obligatorio

Cualquiera de:

integer

integer

>= 1

null

null

column

obligatorio

Cualquiera de:

integer

integer

>= 1

null

null

null

null

consumerInvoices

obligatorio

Array<object>

object

eNcf

obligatorio

string

sourceRow

obligatorio

integer

>= 1

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

Idempotent-Replayed

string

Valor permitido: true

true cuando esta respuesta repite el resultado guardado de una solicitud anterior con la misma clave de idempotencia (Idempotency-Key).

400

400

No se pudo entender la solicitud.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "No se pudo entender la solicitud.",
  "status": 400,
  "code": "parameter_missing",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: parameter_missing parameter_invalid request_body_malformed

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 400

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

401

401

La credencial falta, tiene un formato incorrecto o ya no es válida.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La credencial falta, tiene un formato incorrecto o ya no es válida.",
  "status": 401,
  "code": "person_session_missing",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: person_session_missing api_key_missing api_key_invalid checkout_token_invalid checkout_token_expired

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 401

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

403

403

La credencial es válida, pero no tiene permiso para realizar esta operación.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La credencial es válida, pero no tiene permiso para realizar esta operación.",
  "status": 403,
  "code": "operation_not_permitted",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: operation_not_permitted

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 403

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

404

404

Ningún endpoint sirve este método y ruta, o no existe un recurso con este identificador dentro del alcance del solicitante.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "Ningún endpoint sirve este método y ruta, o no existe un recurso con este identificador dentro del alcance del solicitante.",
  "status": 404,
  "code": "business_not_found",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: business_not_found

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 404

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

409

409

La solicitud entra en conflicto con el estado actual del recurso o con una solicitud anterior que usó la misma clave de idempotencia (Idempotency-Key).

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La solicitud entra en conflicto con el estado actual del recurso o con una solicitud anterior que usó la misma clave de idempotencia (`Idempotency-Key`).",
  "status": 409,
  "code": "business_certification_requirements_unmet",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: business_certification_requirements_unmet business_certification_test_set_required business_certification_test_set_changed business_certification_test_run_in_progress idempotency_key_reused certification_environment_required idempotency_key_conflict

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 409

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

413

413

El cuerpo de la solicitud es más grande de lo que acepta este endpoint.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "El cuerpo de la solicitud es más grande de lo que acepta este endpoint.",
  "status": 413,
  "code": "request_body_too_large",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: request_body_too_large

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 413

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

415

415

El cuerpo de la solicitud tiene un tipo de contenido que este endpoint no acepta.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "El cuerpo de la solicitud tiene un tipo de contenido que este endpoint no acepta.",
  "status": 415,
  "code": "unsupported_media_type",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: unsupported_media_type

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 415

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

500

500

La solicitud no pudo completarse. Recupera el resultado con la referencia guardada o repite la solicitud con la misma clave de idempotencia.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La solicitud no pudo completarse. Recupera el resultado con la referencia guardada o repite la solicitud con la misma clave de idempotencia.",
  "status": 500,
  "code": "internal_error",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: internal_error

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 500

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

503

503

Un servicio requerido no está disponible temporalmente. Inténtalo de nuevo con la misma referencia o la misma clave de idempotencia.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "Un servicio requerido no está disponible temporalmente. Inténtalo de nuevo con la misma referencia o la misma clave de idempotencia.",
  "status": 503,
  "code": "business_certification_unavailable",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: business_certification_unavailable

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 503

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.