Emitir una nota de remisión electrónica

La Nota de Remisión Electrónica (tipo_de: 7) documenta el traslado físico de mercadería, independientemente de si hay una venta asociada. A diferencia de una factura, no lleva precios ni IVA — describe qué se traslada, por qué, y cómo (vehículo, transportista, origen y destino). Usos típicos:

Traslado de mercadería por una venta (con o sin factura ya emitida).
Traslado entre locales de la misma empresa, o hacia/desde depósitos.
Traslado por consignación, exportación, importación, devolución o reparación.

Variables del ejemplo

export EMITI_BASE_URL="https://api.emiti.fravelabs.com"
export EMITI_API_KEY="emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"

Caso 1 — Traslado por venta, transporte terrestre

Vendiste mercadería y la trasladás desde tu depósito en Asunción hasta el local del cliente en Ñemby, en un camión de un transportista tercero.

curl -s "$EMITI_BASE_URL/v1/de/emitir" \
  -X POST \
  -H "Authorization: ApiKey $EMITI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "establecimiento": "001",
    "punto": "001",
    "tipo_de": 7,
    "id_interno": "NR-2026-0001",
    "info_fiscal": "Traslado de mercadería por venta — Art. 3 Inc. 7 RG 41/2014.",
    "receptor": {
      "nombre": "Depósito Central SA",
      "ruc": "80099001-3",
      "tipo_documento": 1,
      "numero_documento": "99001",
      "direccion": "Ruta 2 Km 25",
      "codigo_departamento": 12,
      "codigo_ciudad": 145,
      "descripcion_ciudad": "Ñemby"
    },
    "items_remision": [
      {
        "descripcion": "Bolsas de cemento 50kg",
        "cantidad": "200.0",
        "unidad_medida": 77
      }
    ],
    "remision": {
      "motivo": 1,
      "responsable": 1,
      "kilometros": 28,
      "fecha_factura": "2026-08-01"
    },
    "transporte": {
      "tipo_transporte": 2,
      "modalidad": 1,
      "responsable_flete": 1,
      "fecha_inicio_traslado": "2026-08-04",
      "fecha_fin_traslado": "2026-08-04",
      "local_salida": {
        "direccion": "Av. Artigas 1500",
        "codigo_departamento": 1,
        "codigo_ciudad": 1,
        "descripcion_ciudad": "Asunción"
      },
      "locales_entrega": [
        {
          "direccion": "Ruta 2 Km 25",
          "codigo_departamento": 12,
          "codigo_ciudad": 145,
          "descripcion_ciudad": "Ñemby"
        }
      ],
      "vehiculos": [
        {
          "tipo_vehiculo": "CAMION",
          "marca": "Volvo",
          "tipo_identificacion": 2,
          "numero_matricula": "ABC123"
        }
      ],
      "transportista": {
        "naturaleza": 1,
        "nombre": "Transportes del Este SA",
        "ruc": "80099887",
        "dv_ruc": 4,
        "chofer_documento": "3456789",
        "chofer_nombre": "Ramón Duarte",
        "chofer_domicilio_fiscal": "Ñemby, Central",
        "chofer_direccion": "Calle Los Pinos 234"
      }
    }
  }'

Campos clave:

tipo_de: 7 → nota de remisión.
info_fiscal es obligatorio para Nota de Remisión (Art. 3 Inc. 7 RG 41/2014) — en los demás tipos de DE es opcional.
items_remision, no items — sin precio ni IVA. Describe qué se traslada.
remision.motivo: 1 → traslado por venta. Como no se envía doc_asociado (la factura aún no se emitió o no se referencia), remision.fecha_factura es obligatoria.
receptor con domicilio completo: direccion, codigo_departamento, codigo_ciudad y descripcion_ciudad son obligatorios en toda Nota de Remisión (a diferencia de otros tipos de DE, donde el domicilio del receptor es opcional).
transporte.tipo_transporte: 2 → tercero (el vehículo no es de tu empresa).
transporte.local_salida y al menos un elemento en locales_entrega son obligatorios — describen origen y destino físico del traslado.
transporte.vehiculos: al menos un vehículo. tipo_identificacion: 2 → identificado por matrícula (numero_matricula). Con tipo_identificacion: 1 usá numero_identificacion en su lugar.
transporte.transportista: el bloque de chofer (chofer_documento, chofer_nombre, chofer_domicilio_fiscal, chofer_direccion) siempre es obligatorio, sea cual sea la naturaleza del transportista.

Traslado ya facturado

Si la factura ya fue emitida, referenciala con doc_asociado en lugar de remision.fecha_factura:

{
  "tipo_de": 7,
  "remision": { "motivo": 1, "responsable": 1 },
  "doc_asociado": {
    "tipo": 1,
    "cdc": "01548730457001001000000012026070712345678X"
  },
  "...": "..."
}

Otros motivos de traslado

Importación (remision.motivo: 5): transporte.numero_despacho (16 caracteres) es obligatorio.
Traslado aéreo (transporte.modalidad: 3): cada vehículo en transporte.vehiculos necesita numero_vuelo (6 caracteres exactos).
Otro motivo (remision.motivo: 99): remision.descripcion_motivo (5–60 chars) es obligatorio.

Ver la tabla completa de motivos en la referencia del endpoint.

Validaciones que hace e-Miti antes de enviar a SIFEN

SIFEN declara varios de estos campos como opcionales en el XSD pero rechaza el documento si faltan — e-Miti los valida antes de encolar el envío, para no comerse el round-trip de rechazo:

info_fiscal presente (Art. 3 Inc. 7 RG 41/2014).
Domicilio del receptor completo.
remision.fecha_factura si el motivo es traslado por venta y no hay doc_asociado.
transporte.tipo_transporte, fechas de inicio/fin de traslado, local_salida, al menos un elemento en locales_entrega, al menos un vehículo y los datos del transportista.
transporte.fecha_fin_traslado no puede ser anterior a transporte.fecha_inicio_traslado.
transporte.numero_despacho si el motivo es importación.
numero_vuelo en cada vehículo si la modalidad es aérea.

Errores típicos

Código	Causa	Acción
`NR_INFO_FISCAL_FALTANTE`	Falta `info_fiscal`.	Completar `info_fiscal` con el mensaje al Fisco.
`NR_RECEPTOR_DOMICILIO_FALTANTE`	Falta `direccion`, `codigo_departamento` o `codigo_ciudad` del receptor.	Completar el domicilio del receptor. Ver `extra.faltantes`.
`NR_FECHA_FACTURA_FALTANTE`	`remision.motivo: 1` sin `doc_asociado` ni `remision.fecha_factura`.	Completar `remision.fecha_factura`, o referenciar la factura con `doc_asociado`.
`NR_TRANSPORTE_INCOMPLETO`	Falta algún campo obligatorio de `transporte`.	Revisar `extra.faltantes` — indica exactamente qué falta.
`NR_TRANSPORTE_FECHA_TRASLADO_INVALIDA`	`fecha_fin_traslado` anterior a `fecha_inicio_traslado`.	Ajustar las fechas.
`NR_VEHICULO_NUMERO_VUELO_FALTANTE`	Modalidad aérea sin `numero_vuelo` en algún vehículo.	Completar `numero_vuelo` (6 caracteres) en cada vehículo.

Siguiente paso

Mismo flujo que cualquier DE: polling de estado hasta A. El detalle (GET /v1/de/{cdc}) incluye el bloque remision con todos los datos de traslado.

Empezar

Conceptos

Tutoriales — Emisión

Tutoriales — Eventos y errores

Errores

Emitir una nota de remisión electrónica

Variables del ejemplo

Caso 1 — Traslado por venta, transporte terrestre

Traslado ya facturado

Otros motivos de traslado

Validaciones que hace e-Miti antes de enviar a SIFEN

Errores típicos

Siguiente paso

​Variables del ejemplo

​Caso 1 — Traslado por venta, transporte terrestre

​Traslado ya facturado

​Otros motivos de traslado

​Validaciones que hace e-Miti antes de enviar a SIFEN

​Errores típicos

​Siguiente paso

Variables del ejemplo

Caso 1 — Traslado por venta, transporte terrestre

Traslado ya facturado

Otros motivos de traslado

Validaciones que hace e-Miti antes de enviar a SIFEN

Errores típicos

Siguiente paso