Consultar una recepción

PUT /api/receptions/{key}/v4

Este endpoint permite consultar una recepción realizada ante el Ministerio de Hacienda. Hace el proceso directo de siempre ir a Hacienda a consultar el estado de la recepción y obtener la respuesta volver a marcar el documento con la respuesta y guardar los metadatos de la operación.

Aquí se especifica la clase de salida: CheckReceptionResponse

Parámetros

key (string)

Representa la clave de la recepción. Es obligatorio y forma parte del URL de la llamada al endpoint. Valor de ejemplo: 50617062500310137293502000001010000000109119079365

includeData (bool) (opcional)

Este parámetro se puede enviar por medio del query string. Su valor por defecto es false. Le indica al endpoint si debe devolver el XML firmado en base64.

Esto permite que los clientes que consumen el API pueden elegir entre obtener los XML directos en las respuestas o obtenerlos después en llamadas individuales.

includeDataResponse (bool) opcional

Este parámetro se puede enviar por medio del query string. Su valor por defecto es false. Le indica al endpoint si debe devolver el XML de respuesta en base64.

Esto permite que los clientes que consumen el API pueden elegir entre obtener los XML directos en las respuestas o obtenerlos después en llamadas individuales.

Respuestas Esperadas

HTTP 200 OK

El documento ha sido procesado exitosamente y se ha consultado al Ministerio de Hacienda. Los datos han sido almacenados y son enviados al cliente.

HTTP 500 Internal Server Error

Ocurrio un error interno o hubo un problema en la comunicación con Hacienda.

Ejemplo

Llamada

    curl -X 'PUT' \
    'https://api44.qupos.com/api/receptions/50603042300310140926100200001050000019023171187576/v4' \
    -H 'accept: text/plain' \
    -H 'AuthToken: TOKEN_UNICO' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Basic bmNxOk5DUVXXXXXXXXAwNzA1'
    }'

    {
        "consecutivo": "16",
        "numero_documento": "02000001050000000016",
        "clave": "50612082500310140926102000001050000000016119079365",
        "estado": "01",
        "estado_humanizado": "Accepted",
        "codigo_mensaje_hacienda": "1",
        "mensaje_hacienda": "Aceptado",
        "detalle_mensaje_hacienda": [
            "1- Este comprobante fue recibido en el ambiente de pruebas, por lo cual no tiene validez para fines tributarios."
        ],
        "xml": "",
        "xml_respuesta": "",
        "mensaje_api": "",
        "mensaje_api_key": ""
    }