.. _formato_pue_solicitud_z: 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 :ref:`formato_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: :ref:`st_aduanas` * **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: :: 1: Transporte marítimo 2: Transporte por ferrocarril 3: Transporte por carretera 4: Transporte por vía aérea 5: Envíos postales 7: Instalaciones de transporte fijas 8: Transporte por vías de navegación interior 9: Autopropulsión 0: 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: :ref:`st_paises` * **pais_origen**: Lista de valores predefinidos. | Valores aceptados: :ref:`st_paises` * **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: :ref:`st_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: :ref:`st_paises` * **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: :ref:`st_aduanas` * **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: :: 1: Transporte marítimo 2: Transporte por ferrocarril 3: Transporte por carretera 4: Transporte por vía aérea 5: Envíos postales 7: Instalaciones de transporte fijas 8: Transporte por vías de navegación interior 9: Autopropulsión 0: 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: :ref:`st_paises` * **pais_origen**: Lista de valores predefinidos. | Valores aceptados: :ref:`st_paises` * **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: :ref:`st_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: :ref:`st_paises` * **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 } ] }