Sifende
Guías

Nota de Remisión

Emití una nota de remisión electrónica por API para documentar un traslado de mercadería, esperá la aprobación de SIFEN y descargá el KuDE.

Actualizado el

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: Prepará 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.json

La 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

DatoQué revisar
ReceptorNo admite INNOMINADO. Informá direccion y numeroCasa; para un receptor nacional, también departamento y ciudad, con pais: "PRY"
Traslado entre localesEl receptor debe ser contribuyente y tener el RUC del emisor
Traslado por ventasSi no asociás una factura, informá fechaFacturaFutura; su mes y año no pueden ser posteriores a los de la emisión
Motivo OTRORequiere descripcionMotivoTraslado; omití esa descripción para los demás motivos
Fechas del trasladofechaFinTraslado no puede ser anterior a fechaInicioTraslado
VehículoCon 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.

En esta página

Usamos cookies necesarias para que el sitio funcione. Con tu permiso, también usamos herramientas de analítica para entender cómo se usa el sitio y para medir nuestras campañas publicitarias. Política de privacidad