Generar reporte de un periodo

POST

/emitters/{id}/fiscal/reports

curl --request POST \
  --url https://api.sudte.com/v1/emitters/example/fiscal/reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "type": "example", "period": "example", "params": {} }'

202 en cola; 200 si ya existe un resultado vigente (mismo input_hash) o el periodo está cerrado (snapshot).

Autorización

• apiKey
• session

Parámetros

Parámetros de ruta

id

obligatorio

string

Cuerpo de la solicitud^obligatorio

Media type application/json

object

type

obligatorio

string

period

obligatorio

string

/^\d{4}-\d{2}$/

params

object

Example ^generated

{
  "type": "example",
  "period": "example",
  "params": {}
}

Respuestas

200

Resultado existente

Media type application/json

object

id

string

emitter_id

string

type

string

period

string

status

string

Allowed values: queued running ready failed

period_status

string

Allowed values: open closed

input_hash

string

rules_version

string

generated_at

string format: date-time

totals

object

key

additional properties

string

/^-?\d+(\.\d{1,8})?$/

warnings

Array<object>

object

code

string

message

string

document_id

string

drift

Periodo cerrado con cambios posteriores en las entradas

boolean

Example

{
  "status": "queued",
  "period_status": "open",
  "totals": {
    "additionalProperty": "113.00"
  }
}

202

En cola

Media type application/json

object

id

string

emitter_id

string

type

string

period

string

status

string

Allowed values: queued running ready failed

period_status

string

Allowed values: open closed

input_hash

string

rules_version

string

generated_at

string format: date-time

totals

object

key

additional properties

string

/^-?\d+(\.\d{1,8})?$/

warnings

Array<object>

object

code

string

message

string

document_id

string

drift

Periodo cerrado con cambios posteriores en las entradas

boolean

Example

{
  "status": "queued",
  "period_status": "open",
  "totals": {
    "additionalProperty": "113.00"
  }
}

default

Error (RFC 9457)

Media type application/problem+json

object

type

string format: uri

title

string

status

integer

detail

string

instance

string

request_id

string

errors

Array<object>

object

path

string

message

string

mh

object

codigoMsg

string

descripcionMsg

string

observaciones

Array<string>

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "errors": [
    {
      "path": "example",
      "message": "example"
    }
  ],
  "mh": {
    "codigoMsg": "example",
    "descripcionMsg": "example",
    "observaciones": [
      "example"
    ]
  }
}