PUE Solicitud Z¶

La Solicitud Z del PUE (Punto Único de Entrada) permite solicitar a la AEAT una clave Z para mercancías sujetas a control SOIVRE. La clave Z obtenida (mrn_z) y su partida se utilizan después en el PUE con tipo de documento Z (ver PUE).

Los operadores se enlazan mediante los campos destinatario_id (clientes), exportador_id (remitentes) y agente_id (agentes).

Exportación de datos¶

Campos¶

expediente: Alfanumérico. Obligatorio.

Tamaño máximo: 22
aduana_despacho: Lista de valores predefinidos.

Valores aceptados: Aduanas Españolas
agente_id: Entero.
deposito: Alfanumérico.

Tamaño máximo: 40
destinatario_id: Entero.
envios: Lista.
- asunto: Alfanumérico.
  
  Tamaño máximo: 250
- clave_organismo: Alfanumérico.
  
  Tamaño máximo: 100
- clave_solicitud: Alfanumérico.
  
  Tamaño máximo: 16
- codigo_respuesta: Alfanumérico.
  
  Tamaño máximo: 4
- descripcion_respuesta: Alfanumérico.
  
  Tamaño máximo: 250
- email_mensaje: Alfanumérico.
  
  Tamaño máximo: 40
- es_test: Entero.
- estado_declaracion: Alfanumérico.
  
  Tamaño máximo: 2
- etiqueta: Alfanumérico.
  
  Tamaño máximo: 35
- expediente: Alfanumérico.
  
  Tamaño máximo: 22
- fecha_envio: Fecha y hora.
  
  Formato: %Y-%m-%dT%H:%M:%S
- fecha_fin_validez: Fecha.
  
  Formato: %Y-%m-%d
- fecha_ini_validez: Fecha.
  
  Formato: %Y-%m-%d
- fecha_respuesta: Fecha y hora.
  
  Formato: %Y-%m-%dT%H:%M:%S
- identificador_transaccion: Alfanumérico.
  
  Tamaño máximo: 40
- medidas: Lista.
  apto: Alfanumérico.
  
  Tamaño máximo: 2
  
  clave_partida: Alfanumérico.
  
  Tamaño máximo: 23
  
  codigo: Alfanumérico.
  
  Tamaño máximo: 3
- mensaje: Alfanumérico.
  
  Tamaño máximo: 600
- mensaje_recibido: Alfanumérico.
  
  Tamaño máximo: 1000
- mrn_partida: Alfanumérico.
  
  Tamaño máximo: 23
- mrn_z: Alfanumérico.
  
  Tamaño máximo: 18
- observaciones: Alfanumérico.
  
  Tamaño máximo: 512
- referencia_certificado: Alfanumérico.
  
  Tamaño máximo: 35
- tipo_operacion: Alfanumérico.
  
  Tamaño máximo: 3
- valor_original: Alfanumérico.
  
  Tamaño máximo: 600
estado_envio: Entero.
exportador_id: Entero.
fecha_creacion: Fecha y hora.

Formato: %Y-%m-%dT%H:%M:%S
fecha_registro: Fecha y hora.

Formato: %Y-%m-%dT%H:%M:%S
identidad_transporte_aduana: Alfanumérico.

Tamaño máximo: 35
localizacion_mercancias: Alfanumérico.

Tamaño máximo: 40

modo_transporte_frontera: Lista de valores predefinidos.

Valores aceptados:

Transporte marítimo
Transporte por ferrocarril
Transporte por carretera
Transporte por vía aérea
Envíos postales
Instalaciones de transporte fijas
Transporte por vías de navegación interior
Autopropulsión
Otros

mrn_z: Alfanumérico.

Tamaño máximo: 18
nombre_usuario_declarante: Alfanumérico.

Tamaño máximo: 20
nombre_usuario_ultima_modificacion: Alfanumérico.

Tamaño máximo: 20
numero_referencia_c7: Alfanumérico.

Tamaño máximo: 35
observaciones: Alfanumérico.

Tamaño máximo: 100
pais_destino: Lista de valores predefinidos.

Valores aceptados: Países
pais_origen: Lista de valores predefinidos.

Valores aceptados: Países
partidas: Lista.
- cantidad_divisas: Número con formato cadena con «,» como separador de decimales.
  
  Número de decimales: 3
- codigo_nc: Código partida arancelaria.
- contenedores: Lista.
  contenedor: Alfanumérico.
  
  Tamaño máximo: 20
- descripcion_mercancia: Alfanumérico.
  
  Tamaño máximo: 100
- documentos_precedentes: Lista.
  codigo_documento: Alfanumérico.
  
  Tamaño máximo: 10
  
  numero: Alfanumérico.
  
  Tamaño máximo: 39
- embalajes: Lista.
  cantidad: Número con formato cadena sin decimales.
  
  piezas: Número con formato cadena sin decimales.
  
  tipo: Lista de valores predefinidos.
  
  Valores aceptados: Embalajes
- masa_bruta: Número con formato cadena con «,» como separador de decimales.
  
  Número de decimales: 3
- masa_neta: Número con formato cadena con «,» como separador de decimales.
  
  Número de decimales: 3
- motivos_cambio_peso: Lista.
  imputaciones: Alfanumérico.
  
  Tamaño máximo: 100
  
  referencia_c44: Alfanumérico.
  
  Tamaño máximo: 100
  
  tipo: Alfanumérico.
  
  Tamaño máximo: 100
- pais_origen: Lista de valores predefinidos.
  
  Valores aceptados: Países
referencia_grupo: Alfanumérico.

Tamaño máximo: 50
total_bultos: Número con formato cadena sin decimales.
total_divisas: Número con formato cadena con «,» como separador de decimales.

Número de decimales: 3

Ejemplos¶

{
    "remitentes": [
        {
            "avisos": [],
            "certificados": [],
            "id": 165,
            "nombre": "TARIC, S.A.U.",
            "codigo": "CODIGO",
            "prefijo_telefono": null,
            "numero_telefono": null,
            "extension_telefono": null,
            "numero_fax": null,
            "direccion": "BOIX Y MORER 6 6\u00ba",
            "localidad": "MADRID",
            "codigo_postal": "1",
            "nombre_provincia": null,
            "pais": "GB",
            "identificacion_fiscal": "A78587268",
            "eori": null,
            "proc_simplificado_canarias": null,
            "e_mail": "informatica@taric.es",
            "tipo_persona": null,
            "numero_calle": null
        }
    ],
    "clientes": [
        {
            "firmantes": [],
            "avisos": [],
            "avales": [],
            "certificados": [],
            "id": 4,
            "nombre": "TARIC S.A.",
            "codigo": "SQL0005",
            "nif": "A78587268",
            "prefijo_telefono": null,
            "numero_telefono": null,
            "extension_telefono": null,
            "numero_fax": null,
            "direccion": "CALLE BOIX Y MORER 6 6\u00ba",
            "localidad": "MADRID",
            "codigo_postal_espana": "003",
            "codigo_provincia": "28",
            "clave_declarante": "I",
            "garantia": "999GGA78587268L",
            "aduana_habitual": null,
            "forma_pago": null,
            "pais": "ES",
            "codigo_postal_cee": null,
            "nombre_provincia": null,
            "cuenta_contable": null,
            "nombre_facturacion": null,
            "direccion_facturacion": null,
            "localidad_facturacion": null,
            "codigo_postal_facturacion": null,
            "nombre_provincia_facturacion": null,
            "recargo_equivalencia": null,
            "linea1_casilla14": null,
            "linea2_casilla14": null,
            "forma_pago2": null,
            "tipo_receptor_transito": 3,
            "acogido_domiciliacion": 0,
            "recapitulativos_exportacion": 0,
            "autorizacion": null,
            "codigo_expedidor_autorizado": "PS",
            "usar_sello_expedidor": 0,
            "ubicacion_expedidor": "9999000002",
            "modo_pago": "R",
            "e_mail": "INFORMATICA@TARIC.ES",
            "garantia_cabildo": null,
            "garantia_transito": "114ES0009990000020",
            "e_mail2": "INFORMATICA@TARIC.ES",
            "eori": "ESA78587268",
            "plazo_cobro": 30,
            "iva_diferido": 1,
            "tipo_persona": "F",
            "numero_calle": "6",
            "centro_comex": null,
            "intermediario_id": null
        }
    ],
    "agentes": [],
    "puezs": [
        {
            "partidas": [
                {
                    "embalajes": [
                        {
                            "tipo": "CT",
                            "cantidad": "10",
                            "piezas": null
                        }
                    ],
                    "contenedores": [
                        {
                            "contenedor": "MSKU1234565"
                        }
                    ],
                    "documentos_precedentes": [
                        {
                            "codigo_documento": "N337",
                            "numero": "26ES00280100000001"
                        }
                    ],
                    "motivos_cambio_peso": [],
                    "descripcion_mercancia": "Calefactores con ventilador incorporado",
                    "codigo_nc": "85162991",
                    "pais_origen": "CN",
                    "masa_bruta": "250",
                    "masa_neta": "200",
                    "cantidad_divisas": "1500"
                }
            ],
            "envios": [],
            "id": 1,
            "completo": 1,
            "expediente": "PUEZ000001",
            "referencia_grupo": null,
            "observaciones": null,
            "fecha_creacion": "2026-10-01T10:15:30",
            "fecha_registro": null,
            "estado_envio": null,
            "nombre_usuario_ultima_modificacion": "USUARIO",
            "nombre_usuario_declarante": null,
            "aduana_despacho": "2801",
            "agente_id": null,
            "destinatario_id": 4,
            "exportador_id": 165,
            "pais_origen": "CN",
            "pais_destino": "ES",
            "deposito": "12345",
            "localizacion_mercancias": "ES002801AAAAAA",
            "total_divisas": "1500",
            "numero_referencia_c7": "ESHA123456",
            "identidad_transporte_aduana": "BARCO007",
            "modo_transporte_frontera": "1",
            "total_bultos": "10",
            "mrn_z": null,
            "display_estado": "-----------",
            "registered": false
        }
    ]
}

Importación de datos¶

Campos¶

expediente: Alfanumérico. Obligatorio.

Tamaño máximo: 22
aduana_despacho: Lista de valores predefinidos.

Valores aceptados: Aduanas Españolas
agente_id: Entero.
deposito: Alfanumérico.

Tamaño máximo: 40
destinatario_id: Entero.
estado_envio: Entero.
exportador_id: Entero.
fecha_creacion: Fecha y hora.

Formato: %Y-%m-%dT%H:%M:%S
fecha_registro: Fecha y hora.

Formato: %Y-%m-%dT%H:%M:%S
identidad_transporte_aduana: Alfanumérico.

Tamaño máximo: 35
localizacion_mercancias: Alfanumérico.

Tamaño máximo: 40

modo_transporte_frontera: Lista de valores predefinidos.

Valores aceptados:

Transporte marítimo
Transporte por ferrocarril
Transporte por carretera
Transporte por vía aérea
Envíos postales
Instalaciones de transporte fijas
Transporte por vías de navegación interior
Autopropulsión
Otros

mrn_z: Alfanumérico.

Tamaño máximo: 18
nombre_usuario_declarante: Alfanumérico.

Tamaño máximo: 20
nombre_usuario_ultima_modificacion: Alfanumérico.

Tamaño máximo: 20
numero_referencia_c7: Alfanumérico.

Tamaño máximo: 35
observaciones: Alfanumérico.

Tamaño máximo: 100
pais_destino: Lista de valores predefinidos.

Valores aceptados: Países
pais_origen: Lista de valores predefinidos.

Valores aceptados: Países
partidas: Lista.
- cantidad_divisas: Número con formato cadena con «,» como separador de decimales.
  
  Número de decimales: 3
- codigo_nc: Código partida arancelaria.
- contenedores: Lista.
  contenedor: Alfanumérico.
  
  Tamaño máximo: 20
- descripcion_mercancia: Alfanumérico.
  
  Tamaño máximo: 100
- documentos_precedentes: Lista.
  codigo_documento: Alfanumérico.
  
  Tamaño máximo: 10
  
  numero: Alfanumérico.
  
  Tamaño máximo: 39
- embalajes: Lista.
  cantidad: Número con formato cadena sin decimales.
  
  piezas: Número con formato cadena sin decimales.
  
  tipo: Lista de valores predefinidos.
  
  Valores aceptados: Embalajes
- masa_bruta: Número con formato cadena con «,» como separador de decimales.
  
  Número de decimales: 3
- masa_neta: Número con formato cadena con «,» como separador de decimales.
  
  Número de decimales: 3
- motivos_cambio_peso: Lista.
  imputaciones: Alfanumérico.
  
  Tamaño máximo: 100
  
  referencia_c44: Alfanumérico.
  
  Tamaño máximo: 100
  
  tipo: Alfanumérico.
  
  Tamaño máximo: 100
- pais_origen: Lista de valores predefinidos.
  
  Valores aceptados: Países
referencia_grupo: Alfanumérico.

Tamaño máximo: 50
total_bultos: Número con formato cadena sin decimales.
total_divisas: Número con formato cadena con «,» como separador de decimales.

Número de decimales: 3

Ejemplos¶

{
    "remitentes": [
        {
            "avisos": [],
            "certificados": [],
            "id": 165,
            "nombre": "TARIC, S.A.U.",
            "codigo": "CODIGO",
            "prefijo_telefono": null,
            "numero_telefono": null,
            "extension_telefono": null,
            "numero_fax": null,
            "direccion": "BOIX Y MORER 6 6\u00ba",
            "localidad": "MADRID",
            "codigo_postal": "1",
            "nombre_provincia": null,
            "pais": "GB",
            "identificacion_fiscal": "A78587268",
            "eori": null,
            "proc_simplificado_canarias": null,
            "e_mail": "informatica@taric.es",
            "tipo_persona": null,
            "numero_calle": null
        }
    ],
    "clientes": [
        {
            "firmantes": [],
            "avisos": [],
            "avales": [],
            "certificados": [],
            "id": 4,
            "nombre": "TARIC S.A.",
            "codigo": "SQL0005",
            "nif": "A78587268",
            "prefijo_telefono": null,
            "numero_telefono": null,
            "extension_telefono": null,
            "numero_fax": null,
            "direccion": "CALLE BOIX Y MORER 6 6\u00ba",
            "localidad": "MADRID",
            "codigo_postal_espana": "003",
            "codigo_provincia": "28",
            "clave_declarante": "I",
            "garantia": "999GGA78587268L",
            "aduana_habitual": null,
            "forma_pago": null,
            "pais": "ES",
            "codigo_postal_cee": null,
            "nombre_provincia": null,
            "cuenta_contable": null,
            "nombre_facturacion": null,
            "direccion_facturacion": null,
            "localidad_facturacion": null,
            "codigo_postal_facturacion": null,
            "nombre_provincia_facturacion": null,
            "recargo_equivalencia": null,
            "linea1_casilla14": null,
            "linea2_casilla14": null,
            "forma_pago2": null,
            "tipo_receptor_transito": 3,
            "acogido_domiciliacion": 0,
            "recapitulativos_exportacion": 0,
            "autorizacion": null,
            "codigo_expedidor_autorizado": "PS",
            "usar_sello_expedidor": 0,
            "ubicacion_expedidor": "9999000002",
            "modo_pago": "R",
            "e_mail": "INFORMATICA@TARIC.ES",
            "garantia_cabildo": null,
            "garantia_transito": "114ES0009990000020",
            "e_mail2": "INFORMATICA@TARIC.ES",
            "eori": "ESA78587268",
            "plazo_cobro": 30,
            "iva_diferido": 1,
            "tipo_persona": "F",
            "numero_calle": "6",
            "centro_comex": null,
            "intermediario_id": null
        }
    ],
    "agentes": [],
    "puezs": [
        {
            "partidas": [
                {
                    "embalajes": [
                        {
                            "tipo": "CT",
                            "cantidad": "10",
                            "piezas": null
                        }
                    ],
                    "contenedores": [
                        {
                            "contenedor": "MSKU1234565"
                        }
                    ],
                    "documentos_precedentes": [
                        {
                            "codigo_documento": "N337",
                            "numero": "26ES00280100000001"
                        }
                    ],
                    "motivos_cambio_peso": [],
                    "descripcion_mercancia": "Calefactores con ventilador incorporado",
                    "codigo_nc": "85162991",
                    "pais_origen": "CN",
                    "masa_bruta": "250",
                    "masa_neta": "200",
                    "cantidad_divisas": "1500"
                }
            ],
            "envios": [],
            "id": 1,
            "completo": 1,
            "expediente": "PUEZ000001",
            "referencia_grupo": null,
            "observaciones": null,
            "fecha_creacion": "2026-10-01T10:15:30",
            "fecha_registro": null,
            "estado_envio": null,
            "nombre_usuario_ultima_modificacion": "USUARIO",
            "nombre_usuario_declarante": null,
            "aduana_despacho": "2801",
            "agente_id": null,
            "destinatario_id": 4,
            "exportador_id": 165,
            "pais_origen": "CN",
            "pais_destino": "ES",
            "deposito": "12345",
            "localizacion_mercancias": "ES002801AAAAAA",
            "total_divisas": "1500",
            "numero_referencia_c7": "ESHA123456",
            "identidad_transporte_aduana": "BARCO007",
            "modo_transporte_frontera": "1",
            "total_bultos": "10",
            "mrn_z": null
        }
    ]
}

PUE Solicitud Z¶

Exportación de datos¶

Campos¶

Ejemplos¶

Importación de datos¶

Campos¶

Ejemplos¶

Page contents

Previous page

Next page

Esta página