Nota de Remisión
Emití una nota de remisión electrónica y descargá el KuDE para acompañar la mercadería.
Usá una Nota de Remisión Electrónica (NRE) para documentar un traslado de mercadería, por ejemplo por consignación o entre locales. Elegí el motivo que corresponda a la operación.
A diferencia de una factura, la NRE describe las mercaderías sin precios ni IVA. El receptor siempre tiene que estar identificado y el bloque transporte es obligatorio.
Paso 1: Armá la solicitud
Este ejemplo muestra un traslado nacional por consignación. Reemplazá las identidades, las fechas y las direcciones por las de tu operación y guardalo como nota-remision.json.
{
"tipoDocumento": "NOTA_DE_REMISION_ELECTRONICA",
"fechaEmision": "2026-10-02T08:00:00",
"tipoEmision": "NORMAL",
"numeroEstablecimiento": 1,
"puntoExpedicion": 1,
"receptor": {
"tipoContribuyente": "NO_CONTRIBUYENTE",
"tipoOperacion": "B2C",
"tipoDocumento": "CEDULA_PARAGUAYA",
"numeroDocumento": "4567890",
"nombreRazonSocial": "Ana González",
"pais": "PRY",
"direccion": "Avenida Mariscal López",
"numeroCasa": 450,
"departamento": "CENTRAL",
"ciudad": "SAN LORENZO"
},
"motivoTraslado": "TRASLADO_POR_CONSIGNACION",
"responsableEmision": "EMISOR_FACTURA",
"kilometrosRecorrido": 8,
"items": [
{
"codigo": "PAP-A4-75",
"descripcion": "Resma de papel A4 de 75 gramos",
"cantidad": 100,
"unidadMedida": "UNI"
}
],
"transporte": {
"tipoTransporte": "PROPIO",
"modalidad": "TERRESTRE",
"responsableFlete": "TRANSPORTE_PROPIO",
"fechaInicioTraslado": "2026-10-02",
"fechaFinTraslado": "2026-10-02",
"salida": {
"direccion": "Calle Teniente Benítez",
"numeroCasa": 120,
"departamento": "CENTRAL",
"ciudad": "SAN LORENZO"
},
"entregas": [
{
"direccion": "Avenida Mariscal López",
"numeroCasa": 450,
"departamento": "CENTRAL",
"ciudad": "SAN LORENZO"
}
],
"vehiculos": [
{
"tipoVehiculo": "CAMION",
"marca": "ISUZU",
"tipoIdentificacion": 2,
"matricula": "ABC1234"
}
],
"transportista": {
"naturaleza": "NO_CONTRIBUYENTE",
"nombreRazonSocial": "Carlos Benítez",
"tipoDocumento": "CEDULA_PARAGUAYA",
"numeroDocumento": "3456789",
"domicilioFiscal": "Calle Teniente Benítez 120, San Lorenzo",
"numeroDocumentoConductor": "3456789",
"nombreConductor": "Carlos Benítez",
"direccionConductor": "Calle Teniente Benítez 120, San Lorenzo"
}
}
}Consultá el modelo de nota de remisión para los campos, los motivos de traslado y las reglas de transporte. En TRASLADO_ENTRE_LOCALES, el receptor tiene que ser contribuyente y tener el mismo RUC que el emisor.
Paso 2: Enviá la nota
curl -X POST https://api.sifende.com.py/api/v1/documento-electronico \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
--data-binary @nota-remision.jsonLa API responde 202 Accepted con el CDC y las URLs de seguimiento. Guardalos para consultar el mismo documento. Para recuperar una respuesta perdida, seguí la guía de idempotencia.
Paso 3: Esperá la aprobación y descargá el KuDE
Consultá el estado hasta obtener APROBADO o APROBADO_OBSERVACION. Antes de iniciar el traslado, descargá el KuDE para acompañar la mercadería. Si la NRE todavía no está aprobada, la descarga responde 403.
Si queda RECHAZADO, revisá el motivo y corregí los datos antes de emitir otra nota. Si queda ERROR o sigue en EN_LOTE después de varias horas, revisá el lote en el panel y continuá el seguimiento con el mismo CDC.
Errores frecuentes
| Dato | Qué revisar |
|---|---|
| Receptor | No admite INNOMINADO. Informá direccion y numeroCasa; para un receptor nacional, también departamento y ciudad, con pais: "PRY" |
| Traslado entre locales | El receptor debe ser contribuyente y tener el RUC del emisor |
| Traslado por ventas | Si no asociás una factura, informá fechaFacturaFutura; su mes y año no pueden ser posteriores a los de la emisión |
Motivo OTRO | Requiere descripcionMotivoTraslado; omití esa descripción para los demás motivos |
| Fechas del traslado | fechaFinTraslado no puede ser anterior a fechaInicioTraslado |
| Vehículo | Con tipoIdentificacion: 1, informá su identificación; con 2, la matricula |
Una solicitud inválida devuelve 400. Consultá los campos señalados en errores y el modelo completo antes de reenviarla.