Nota de Remisión Electrónica

tipoDocumento: NOTA_DE_REMISION_ELECTRONICA ✅ Disponible

La Nota de Remisión Electrónica (NRE) documenta el traslado de mercaderías. Se envía a POST /api/v1/documento-electronico.

Antes de iniciar el traslado

Esperá a que la nota esté en estado APROBADO o APROBADO_OBSERVACION y llevá el KuDE con la mercadería.
Los ítems describen las mercaderías, sin precios ni IVA. No se informan condiciones de pago ni descuentos.
El receptor siempre debe estar identificado. No se admite INNOMINADO.
En importación y exportación, la NRE cubre el tramo paraguayo. No reemplaza la documentación aduanera.

Para un traslado real, emití en PROD. Una nota de DEV o SANDBOX es una prueba sin validez fiscal, aunque figure como APROBADO.

Campos raíz

Campo	Tipo	Requerido	Descripción
`tipoDocumento`	`enum`	Sí	`NOTA_DE_REMISION_ELECTRONICA`
`fechaEmision`	`datetime`	No	Fecha y hora local de Paraguay, sin zona: `YYYY-MM-DDTHH:mm:ss`. Si se omite, se usa la fecha y hora en que Sifende recibe la solicitud
`tipoEmision`	`enum`	No	Sólo `NORMAL`, valor por defecto
`numeroEstablecimiento`	`integer`	Sí	1–999
`puntoExpedicion`	`integer`	Sí	1–999
`receptor`	`object`	Sí	Persona o entidad identificada que recibe la mercadería
`motivoTraslado`	`enum`	Sí	Motivo del catálogo, por ejemplo `TRASLADO_POR_VENTAS`, `TRASLADO_POR_CONSIGNACION`, `TRASLADO_ENTRE_LOCALES`, `IMPORTACION`, `EXPORTACION` u `OTRO`
`descripcionMotivoTraslado`	`string`	Para `OTRO`	5–60 caracteres; se omite para los demás motivos
`responsableEmision`	`enum`	Sí	Responsable de emitir la nota; independiente del transportista y del responsable del flete
`kilometrosRecorrido`	`integer`	Sí	1–99999
`costoFlete`	`number`	No	Importe no negativo, hasta 15 enteros y 8 decimales; no representa una venta ni una base de IVA
`fechaFacturaFutura`	`date`	En ventas sin documentos asociados	`YYYY-MM-DD`; el mes y año no pueden ser posteriores a los de la emisión
`informacionFiscal`	`string`	No	1–3000 caracteres en una sola línea con la información fiscal que corresponda al traslado
`infoEmisor`	`string`	No	1–3000 caracteres en una sola línea de información adicional del emisor
`carga`	`object`	No	Volumen, peso y características de la carga
`items`	`array`	Sí	1–999 mercaderías
`transporte`	`object`	Sí	Recorrido, vehículos, transportista y conductor
`documentosAsociados`	`array`	No	Hasta 99 facturas electrónicas o impresas
`monedaOperacion`	`enum`	No	Se puede omitir o enviar `PYG` (valor predeterminado al omitir el campo; no acepta `null`); la nota no lleva importes comerciales

Consultá los valores de las enumeraciones en GET /api/v1/public/enums. Los campos opcionales pueden omitirse; los textos informados no pueden quedar en blanco. Conservá los ceros iniciales de los campos que se envían como texto.

Receptor

Se aplican las reglas del receptor, con dirección e identificación obligatorias:

Campo	Tipo	Regla
`tipoContribuyente`	`enum`	`CONTRIBUYENTE` o `NO_CONTRIBUYENTE`
`tipoOperacion`	`enum`	Tipo de operación del receptor
`numeroDocumento`	`string`	RUC de 3–8 dígitos sin DV para contribuyentes; documento de 1–20 caracteres para los demás
`digitoVerificador`	`string`	Un dígito, obligatorio y válido para contribuyentes
`tipoContribuyenteReceptor`	`enum`	Obligatorio para contribuyentes: `PERSONA_FISICA` o `PERSONA_JURIDICA`
`tipoDocumento`	`enum`	Obligatorio para no contribuyentes; debe identificar al receptor
`nombreRazonSocial`	`string`	Obligatorio, 4–255 caracteres
`pais`	`enum`	Código de tres letras; `PRY` por defecto y requerido para operaciones distintas de `B2F`
`direccion`	`string`	Obligatoria, 1–255 caracteres
`numeroCasa`	`integer`	Obligatorio, 0–999999; usá `0` si no tiene número
`departamento`, `ciudad`	`string`	Obligatorios para un receptor nacional; deben corresponder al catálogo geográfico
`codigoDistrito`	`integer`	Opcional; permite precisar una ciudad con nombre repetido
`telefono`, `celular`	`string`	Opcionales, 6–15 y 10–20 caracteres respectivamente
`email`	`string`	Opcional, email válido de hasta 80 caracteres

En TRASLADO_ENTRE_LOCALES, el receptor debe ser contribuyente y su RUC debe coincidir con el del emisor. En B2F, usá la dirección y el país reales del receptor extranjero.

Mercaderías: `items[]`

Campo	Tipo	Regla
`codigo`	`string`	Obligatorio, 1–50 caracteres
`descripcion`	`string`	Obligatoria, 1–2000 caracteres
`cantidad`	`number`	Obligatoria, mayor que cero; hasta 10 enteros y 8 decimales
`unidadMedida`	`enum`	Obligatoria; nombre exacto del catálogo
`partidaArancelaria`, `ncm`	`string`	Opcionales, 4 y 6–8 dígitos respectivamente; no pueden contener sólo ceros
`codigoDncpGeneral`, `codigoDncpEspecifico`	`string`	Opcionales, 8 y 3–4 dígitos respectivamente
`gtin`, `gtinPaquete`	`string`	Opcionales, 8, 12, 13 o 14 dígitos; no pueden contener sólo ceros
`paisOrigen`	`enum`	Opcional, país de origen de tres letras
`observacion`	`string`	Opcional, 1–500 caracteres
`tolerancia`	`enum`	Si se informa, exige `toleranciaCantidad` y `toleranciaPorcentaje`
`toleranciaCantidad`	`number`	No negativa, hasta 10 enteros y 4 decimales
`toleranciaPorcentaje`	`number`	0–100, hasta 8 decimales
`lote`	`string`	Identificación de la partida de mercadería, 1–80 caracteres
`vencimiento`	`date`	Fecha de vencimiento de la mercadería, `YYYY-MM-DD`
`numeroSerie`	`string`	1–10 caracteres
`numeroPedido`, `numeroSeguimiento`	`string`	1–20 caracteres cada uno
`numeroRegistroProducto`, `numeroRegistroEntidadComercial`	`string`	1–20 caracteres cada uno
`nombreProducto`	`string`	1–30 caracteres

La tolerancia no reduce la cantidad trasladada ni funciona como un descuento. No envíes precioUnitario, tasaIVA ni otros importes comerciales.

Carga: `carga`

Campo	Tipo	Regla
`unidadMedidaVolumen`, `unidadMedidaPeso`	`enum`	Opcionales, nombres del catálogo `unidadMedida`
`volumenTotal`, `pesoTotal`	`string`	Opcionales, enteros positivos de hasta 20 dígitos, sin ceros iniciales ni decimales
`caracteristica`	`enum`	`MERCADERIA_CON_CADENA_DE_FRIO`, `CARGA_PELIGROSA` u `OTRO`
`descripcionCaracteristica`	`string`	Obligatoria sólo para `OTRO`: 1–50 caracteres, sin saltos de línea

Enviá peso y volumen como texto, por ejemplo "1200". Los datos de carga no reemplazan las instrucciones que deban incluirse en informacionFiscal.

Transporte: `transporte`

Campo	Tipo	Regla
`tipoTransporte`	`enum`	Obligatorio: `PROPIO` o `TERCERO`
`modalidad`	`enum`	Obligatoria: `TERRESTRE`, `FLUVIAL`, `AEREO` o `MULTIMODAL`
`responsableFlete`	`enum`	Obligatorio, valor del catálogo
`fechaInicioTraslado`, `fechaFinTraslado`	`date`	Obligatorias; el fin no puede preceder al inicio y el inicio debe ser posterior al 22/11/2018
`salida`	`object`	Local de salida obligatorio
`entregas`	`array`	De 1 a 99 locales de entrega
`vehiculos`	`array`	De 1 a 4 vehículos
`transportista`	`object`	Obligatorio, incluye los datos del conductor
`incoterm`	`enum`	Opcional, condición de negociación del catálogo
`numeroManifiesto`	`string`	Opcional, 1–15 caracteres
`paisDestino`	`enum`	Opcional, país de tres letras
`numeroDespachoImportacion`	`string`	Obligatorio para `IMPORTACION`, exactamente 16 caracteres

Locales: `salida` y `entregas[]`

Campo	Tipo	Regla
`direccion`	`string`	Obligatoria, 1–255 caracteres
`numeroCasa`	`integer`	Obligatorio, 0–999999; `0` si no tiene número
`departamento`, `ciudad`	`string`	Obligatorios; ubicaciones paraguayas relacionadas entre sí
`codigoDistrito`	`integer`	Opcional; debe pertenecer al departamento
`complementoDireccion1`, `complementoDireccion2`	`string`	Opcionales, 1–255 caracteres cada uno
`telefono`	`string`	Opcional, 6–15 caracteres

Elegí las ubicaciones del catálogo geográfico. Si una ciudad es ambigua, informá codigoDistrito.

Vehículos: `vehiculos[]`

Campo	Tipo	Regla
`tipoVehiculo`	`string`	Obligatorio, 4–10 caracteres
`marca`	`string`	Obligatoria, 1–10 caracteres
`tipoIdentificacion`	`integer`	Obligatorio: `1` exige número de identificación; `2` exige matrícula
`numeroIdentificacion`	`string`	1–20 caracteres
`matricula`	`string`	6–7 caracteres
`datosAdicionales`	`string`	Opcional, 1–20 caracteres
`numeroVuelo`	`string`	Obligatorio sólo en modalidad `AEREO`, exactamente 6 caracteres

Transportista y conductor: `transportista`

Campo	Tipo	Regla
`naturaleza`	`enum`	Obligatoria: `CONTRIBUYENTE` o `NO_CONTRIBUYENTE`
`nombreRazonSocial`	`string`	Obligatorio, 4–60 caracteres
`ruc`, `digitoVerificador`	`string`	Obligatorios para contribuyentes: RUC de 3–8 dígitos y DV válido de un dígito
`tipoDocumento`, `numeroDocumento`	`enum`, `string`	Obligatorios para no contribuyentes; número de 1–20 caracteres
`nacionalidad`	`enum`	Opcional, país de tres letras
`domicilioFiscal`	`string`	Obligatorio, 1–150 caracteres
`numeroDocumentoConductor`	`string`	Obligatorio, 1–20 caracteres
`nombreConductor`	`string`	Obligatorio, 4–60 caracteres
`direccionConductor`	`string`	Obligatoria, 1–255 caracteres
`nombreAgente`	`string`	4–60 caracteres
`rucAgente`, `digitoVerificadorAgente`	`string`	RUC de 3–8 dígitos y DV válido de un dígito
`direccionAgente`	`string`	1–255 caracteres

Un transportista contribuyente se identifica con RUC y DV; un no contribuyente, con documento personal. Los cuatro datos del agente deben enviarse juntos si informás alguno o si responsableFlete es AGENTE_INTERMEDIARIO. El transportista y el conductor son obligatorios también en transporte propio.

Documentos asociados: `documentosAsociados[]`

Sólo se asocian facturas. Usá los campos correspondientes a una de estas dos opciones:

Campo	Tipo	Electrónico	Impreso
`tipoDocumento`	`enum`	`ELECTRONICO`	`IMPRESO`
`cdc`	`string`	Obligatorio, 44 dígitos, con DV válido y prefijo `01`	Se omite
`rucFusionado`	`string`	Opcional, 3–8 dígitos, debe corresponder al emisor del CDC	Se omite
`numeroTimbrado`	`string`	Se omite	Obligatorio, 8 dígitos
`establecimiento`, `puntoExpedicion`	`string`	Se omiten	Obligatorios, 3 dígitos cada uno
`numeroDocumento`	`string`	Se omite	Obligatorio, 7 dígitos
`tipoDocumentoImpreso`	`enum`	Se omite	Obligatorio: `FACTURA`
`fechaEmision`	`date`	Se omite	Obligatoria, `YYYY-MM-DD`

Conservá los ceros iniciales. En TRASLADO_POR_VENTAS, si no hay facturas asociadas, informá fechaFacturaFutura.

Ejemplo nacional completo

Traslado por consignación dentro de San Lorenzo. Reemplazá las identidades, las fechas y las direcciones por las de la operación real.

{
  "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"
    }
  }
}

Ejemplo de importación: tramo local

Estos ejemplos describen el tramo paraguayo del traslado. Reemplazá las fechas, las identidades y los datos aduaneros por los de tu operación. El país del receptor y paisDestino son datos distintos; las direcciones de salida y entrega siguen siendo paraguayas.

{
  "tipoDocumento": "NOTA_DE_REMISION_ELECTRONICA",
  "fechaEmision": "2026-10-03T10:00:00",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "tipoEmision": "NORMAL",
  "receptor": {
    "tipoContribuyente": "NO_CONTRIBUYENTE",
    "tipoOperacion": "B2F",
    "tipoDocumento": "PASAPORTE",
    "numeroDocumento": "AAB123456",
    "nombreRazonSocial": "Martín Fernández",
    "pais": "ARG",
    "direccion": "Avenida Corrientes",
    "numeroCasa": 1234
  },
  "responsableEmision": "EMISOR_FACTURA",
  "kilometrosRecorrido": 320,
  "transporte": {
    "transportista": {
      "naturaleza": "NO_CONTRIBUYENTE",
      "nombreRazonSocial": "João Pereira",
      "tipoDocumento": "PASAPORTE",
      "numeroDocumento": "FZ123456",
      "domicilioFiscal": "Rua das Flores 250, Foz do Iguaçu",
      "numeroDocumentoConductor": "FZ123456",
      "nombreConductor": "João Pereira",
      "direccionConductor": "Rua das Flores 250, Foz do Iguaçu"
    },
    "tipoTransporte": "PROPIO",
    "modalidad": "TERRESTRE",
    "responsableFlete": "TRANSPORTE_PROPIO",
    "fechaInicioTraslado": "2026-10-03",
    "fechaFinTraslado": "2026-10-03",
    "salida": {
      "direccion": "Avenida San Blas",
      "numeroCasa": 150,
      "departamento": "ALTO PARANA",
      "ciudad": "CIUDAD DEL ESTE"
    },
    "entregas": [
      {
        "direccion": "Avenida Fernando de la Mora",
        "numeroCasa": 2300,
        "departamento": "CENTRAL",
        "ciudad": "LUQUE"
      }
    ],
    "vehiculos": [
      {
        "tipoVehiculo": "CAMION",
        "marca": "SCANIA",
        "tipoIdentificacion": 2,
        "matricula": "ABCD123"
      }
    ],
    "incoterm": "FOB",
    "paisDestino": "BRA",
    "numeroManifiesto": "MAN-2026-004512",
    "numeroDespachoImportacion": "26005IC04001234K"
  },
  "items": [
    {
      "codigo": "REP-1042",
      "descripcion": "Repuestos para maquinaria agrícola",
      "cantidad": 40,
      "unidadMedida": "UNI"
    }
  ],
  "motivoTraslado": "IMPORTACION"
}

Ejemplo de exportación: tramo local

{
  "tipoDocumento": "NOTA_DE_REMISION_ELECTRONICA",
  "fechaEmision": "2026-10-03T10:00:00",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "tipoEmision": "NORMAL",
  "receptor": {
    "tipoContribuyente": "NO_CONTRIBUYENTE",
    "tipoOperacion": "B2F",
    "tipoDocumento": "PASAPORTE",
    "numeroDocumento": "AAB123456",
    "nombreRazonSocial": "Martín Fernández",
    "pais": "ARG",
    "direccion": "Avenida Corrientes",
    "numeroCasa": 1234
  },
  "responsableEmision": "EMISOR_FACTURA",
  "kilometrosRecorrido": 320,
  "transporte": {
    "transportista": {
      "naturaleza": "NO_CONTRIBUYENTE",
      "nombreRazonSocial": "João Pereira",
      "tipoDocumento": "PASAPORTE",
      "numeroDocumento": "FZ123456",
      "domicilioFiscal": "Rua das Flores 250, Foz do Iguaçu",
      "numeroDocumentoConductor": "FZ123456",
      "nombreConductor": "João Pereira",
      "direccionConductor": "Rua das Flores 250, Foz do Iguaçu"
    },
    "tipoTransporte": "PROPIO",
    "modalidad": "TERRESTRE",
    "responsableFlete": "TRANSPORTE_PROPIO",
    "fechaInicioTraslado": "2026-10-03",
    "fechaFinTraslado": "2026-10-03",
    "salida": {
      "direccion": "Avenida San Blas",
      "numeroCasa": 150,
      "departamento": "ALTO PARANA",
      "ciudad": "CIUDAD DEL ESTE"
    },
    "entregas": [
      {
        "direccion": "Avenida Fernando de la Mora",
        "numeroCasa": 2300,
        "departamento": "CENTRAL",
        "ciudad": "LUQUE"
      }
    ],
    "vehiculos": [
      {
        "tipoVehiculo": "CAMION",
        "marca": "SCANIA",
        "tipoIdentificacion": 2,
        "matricula": "ABCD123"
      }
    ],
    "incoterm": "FOB",
    "paisDestino": "BRA",
    "numeroManifiesto": "MAN-2026-004512"
  },
  "items": [
    {
      "codigo": "REP-1042",
      "descripcion": "Repuestos para maquinaria agrícola",
      "cantidad": 40,
      "unidadMedida": "UNI"
    }
  ],
  "motivoTraslado": "EXPORTACION"
}

Consultar el resultado

La emisión devuelve 202 Accepted, el CDC y las URLs de seguimiento. Guardá esos datos y consultá el estado. En la respuesta de estado, iTiDe vale 7.

Si la nota está APROBADO o APROBADO_OBSERVACION, descargá el KuDE para acompañar la mercadería. Si está RECHAZADO, corregí el motivo antes de emitir otra. Un timeout o un estado ERROR requiere revisar el documento existente; no emitas otra nota para forzar el resultado.

Nota de Remisión Electrónica

On this page