Este servicio consulta el/los documento/s PDF KuDE de uno o más documentos electrónicos (como máximo 50) desde FacturaSend.
En el caso de incluir más de un CDC, el sistema recuperara 1 sólo documento, pero con varias hojas, cada una de ellas conteneniendo el KuDE de los diferentes documentos electrónicos.
Este servicio no realiza validaciones de estado sobre el Documento Electrónico para obtener el PDF, por lo cual debe saber que puede obtener el PDF tanto de un Documento Electrónico Generado, Aprobado, Rechazado o cualquier otro estado.
Endpoint (URL) #
Obtiene el binario o base64 del PDF del KuDE
POST https://api.facturasend.com.py/<tenantId>/de/pdf
Obtiene el binario o base64 de la Imagen del KuDE
POST https://api.facturasend.com.py/<tenantId>/de/image
Header (Encabezado) #
Requiere el envío del los siguientes atributos en el encabezado
| Campo | Valor |
|---|---|
| Authorization | Bearer api_key_reemplazar_api_key |
Parámetros (BODY) #
{
"cdcList" : [{
"cdc": "01800695631001001038720612021112917595714694"
}, {
"cdc": "01800695631001001000000612021312917595714695"
}, {
"cdc": "otro.."
}],
"type": "base64",
"format": "ticket",
"config" : {
"kudeParam.pygDecimals" : 3,
"kudeParam.pygTaxDecimals" : 3,
"kudeParam.decimals" : 3,
"kudeParam.taxDecimals" : 3,
"kudeParam.hideGlobalDiscountFromItem" : true,
"kude.totalGeneralOnlyInLastPages": true
}
}
| Campo | Requerido | Valor |
|---|---|---|
| cdcList | Si | Array de códigos CDC de los cuales se desea obtener el Documento PDF KuDE |
| type | No | Tipo de información que se desea obtener Por defecto el Documento se recupera en formato Binario. La opción alternativa es ‘base64’ |
| format | No | Especifique el formato para el Documento Electrónico específico, “a4”, “ticket” o “custom”. Si desea obtener el PDF en el formato por defecto del Sistema (especificado en el establecimiento) ignore ésta opción. Si en el establecimiento se especificó como “ticket” puede establecer format=”a4″ para generar dicho documento específico en formato A4. |
| config | No | Configuración del formato KuDE. Ver abajo CLICK AQUI |
Parámetros del objeto data.config #
Son configuraciones que permiten cambiar el comportamiento de la visualización del KuDE. Todos los parámetros que empiezan con “kudeParam.*” se pueden enviar también en la opción data.config al crear el DE, para que dichos pámetros sean utilizados cuando se va generar el KuDE a ser enviado por correo electrónico.
| Campo | Requerido | Valor | |
|---|---|---|---|
| kudeParam.pygDecimals | Si | Configuración del formato decimal. Para más detalles CLICK AQUI | |
| kudeParam.pygTaxDecimals | No | Configuración del formato decimal. Para más detalles CLICK AQUI | |
| kudeParam.decimals | No | Configuración del formato decimal. Para más detalles CLICK AQUI | |
| kudeParam.taxDecimals | No | Configuración del formato decimal. Para más detalles CLICK AQUI | |
| kudeParam.hideGlobalDiscountFromItem | No | Valor booleano true | false Si está true oculta el valor de la columna Descuento/Anticipo de cada Ítem, útil para cuando se hace un descuento global y se desea ocultar la distribución de valores. | |
| kudeParam.totalGeneralOnlyInLastPages | No | Valor booleano true | false Si está true oculta de las primeras paginas el valor total y el impuesto del pie de página del KuDE y muestra sólo en la última página. | |
| kudeParam.infoEmisorInFooterBackground | No | Valor booleano true | false Si está true indica que el campo data.observacion se va mostrar en el pie del informe. Si está false indica que se va mostrar abajo de la columna de descripción Valor por defecto : true | |
| kudeParam.infoAdicionalInFooterBackground | No | Valor booleano true | false Si está true indica que el campo data.infoAdicional se va mostrar en el pie del informe. Si está false indica que se va mostrar abajo de la columna de descripción Valor por defecto : true |
Parámetros (Query Param) #
No posee
Ejemplo de llamadas #
# Obtiene el documento PDF de los Códigos de Control (CDC) que se pasan como parámetro
curl \
-X \
POST "https://api.facturasend.com.py/<tenantId>/de/pdf" \
-H "Authorization: Bearer api_key_<hdiweuw-92jwwle...>" \
-H 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"cdcList" : [{
"cdc": "01800695631001001038720612021112917595714694"
}, {
"cdc": "01800695631001001000000612021312917595714695"
}, {
"cdc": "otro.."
}],
"type": "base64",
"format": "ticket"
}'
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';
const headers = {
`Authorization` : `Bearer api_key_<reemplazar_api_key>`
};
const data = {
"cdcList" : [{
"cdc": "01800695631001001038720612021112917595714694"
}, {
"cdc": "01800695631001001000000612021312917595714695"
}, {
"cdc": "otro.."
}],
"type": "base64",
"format": "ticket"
};
axios.post({
url: `https://api.facturasend.com.py/<tenantId>/de/pdf`,
method: 'POST',
responseType: 'blob',
{headers}
}
).then( respuesta => {
console.log(respuesta);
});
Respuesta de la Petición #
El contenido binario del PDF o el base64 del archivo, según lo especificado en los parámetros del body.
Recomendaciones #
- No aplica
Validaciones #
- No aplica
