G3v2

El mensaje G3v2 es la declaración de presentación de mercancías ante la aduana, declaradas y dispuestas en situación de depósito temporal mediante el mensaje G4, mientras que la versión previa, G3v1, queda vigente exclusivamente para la presentación de mercancías de bajo valor declaradas empleando una Partida Agrupadora de Bajo Valor (PABV) de la DSDT.

A partir de la entrada en vigor del G4, cada uno de los envíos de bajo valor se declarará de forma explícita en el G4, con anterioridad al G3, en un conocimiento house con una o varias partidas, al igual que la introducción de mercancías de alto valor.

Exportación de datos

Campos

• expediente: Alfanumérico. Obligatorio.

  Tamaño máximo: 22

• version: Lista de valores predefinidos. Obligatorio.

  Valores aceptados:

  2: G3v2
  

• aduana: Lista de valores predefinidos.

  Valores aceptados: Aduanas Españolas

• agente_id: Entero.

• clave_declarante: Lista de valores predefinidos.

  Valores aceptados:

  1: Autodespacho (igual a vacío)
  2: Representación directa a tenor del artículo 18. 1 del Código.
  3: Representación indirecta a tenor del artículo 18. 1 del Código.
  

• codigo_levante: Lista de valores predefinidos.

  Valores aceptados:

  VE: Circuito Verde. Levante Permitido
  LN: Levante no permitido para una o varias mercancías
  

• completed: Lista de valores predefinidos.

  Valor por defecto: 0

  Valores aceptados:

  0: No
  1: Si
  

• conocimiento: Alfanumérico.

  Tamaño máximo: 35

• contenedores: Lista.

  • numero: Alfanumérico.

    Tamaño máximo: 17

• csv: Alfanumérico.

  Tamaño máximo: 16

• declarante_id: Entero.

• doc_previo_numero: Alfanumérico.

  Tamaño máximo: 70

• doc_previo_partida: Alfanumérico.

  Tamaño máximo: 5

• doc_previo_tipo: Lista de valores predefinidos.

  Valores aceptados:

  N337
  

• doc_transporte_numero: Alfanumérico.

  Tamaño máximo: 70

• doc_transporte_tipo: Lista de valores predefinidos.

  Valores aceptados:

  5025: NÚMERO DE ENVÍO
  N703: HOJA DE RUTA EMITIDA POR UN TRANSITARIO
  N704: CONOCIMIENTO PRINCIPAL
  N705: CONOCIMIENTO DE EMBARQUE
  N714: CONOCIMIENTO EMITIDO POR UN TRANSITARIO
  N720: CARTA DE PORTE CIM
  N722: LISTA DE ACOMPAÑAMIENTO - SMGS
  N730: BOLETÍN DE EXPEDICIÓN POR CARRETERA
  N740: TÍTULO DE TRANSPORTE AÉREO
  N741: HOJA DE RUTA AÉREA PRINCIPAL
  N750: ENVÍOS POSTALES, INCLUIDOS LOS PAQUETES POSTALES
  N760: DOCUMENTO DE TRANSPORTE MULTIMODAL/COMBINADO
  

• envios: Lista.

  • codigo_levante: Lista de valores predefinidos.

    Valores aceptados:

    VE: Circuito Verde. Levante Permitido
    LN: Levante no permitido para una o varias mercancías
    

  • codigo_operacion: Alfanumérico.

    Tamaño máximo: 1

  • codigo_respuesta: Alfanumérico.

    Tamaño máximo: 2

  • csv: Alfanumérico.

    Tamaño máximo: 16

  • errores: Lista.

    • codigo: Alfanumérico.

      Tamaño máximo: 4

    • descripcion: Alfanumérico.

      Tamaño máximo: 2048

    • localizacion: Alfanumérico.

      Tamaño máximo: 512

  • es_test: Entero.

  • expediente: Alfanumérico.

    Tamaño máximo: 22

  • fecha_envio: Fecha y hora.

    Formato: %Y-%m-%dT%H:%M:%S

  • fecha_respuesta: Fecha y hora.

    Formato: %Y-%m-%dT%H:%M:%S

  • identificador_transaccion: Alfanumérico.

    Tamaño máximo: 40

  • mrn: Alfanumérico.

    Tamaño máximo: 18

  • xml_envio: Alfanumérico.

• estado_envio: Alfanumérico.

  Tamaño máximo: 4

• estado_previo_envio: Alfanumérico.

  Tamaño máximo: 4

• fecha_alta_declaracion: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• fecha_creacion: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• fecha_mrn: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• fecha_presentacion: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• mrn: 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

• observaciones: Alfanumérico.

  Tamaño máximo: 100

• partidas: Lista.

  • codigo_levante: Lista de valores predefinidos.

    Valores aceptados:

    VE: Circuito Verde. Levante Permitido
    LT: En período de latencia
    CA: Pendiente control aduanero
    N7: No existe H7 previamente declarado
    

  • doc_previo_numero: Alfanumérico.

    Tamaño máximo: 70

  • doc_previo_partida: Alfanumérico.

    Tamaño máximo: 5

  • doc_previo_tipo: Lista de valores predefinidos.

    Valores aceptados:

    N337
    

  • doc_transporte_numero: Alfanumérico.

    Tamaño máximo: 70

  • doc_transporte_tipo: Lista de valores predefinidos.

    Valores aceptados:

    5025: NÚMERO DE ENVÍO
    N703: HOJA DE RUTA EMITIDA POR UN TRANSITARIO
    N704: CONOCIMIENTO PRINCIPAL
    N705: CONOCIMIENTO DE EMBARQUE
    N714: CONOCIMIENTO EMITIDO POR UN TRANSITARIO
    N720: CARTA DE PORTE CIM
    N722: LISTA DE ACOMPAÑAMIENTO - SMGS
    N730: BOLETÍN DE EXPEDICIÓN POR CARRETERA
    N740: TÍTULO DE TRANSPORTE AÉREO
    N741: HOJA DE RUTA AÉREA PRINCIPAL
    N750: ENVÍOS POSTALES, INCLUIDOS LOS PAQUETES POSTALES
    N760: DOCUMENTO DE TRANSPORTE MULTIMODAL/COMBINADO
    

  • estado: Alfanumérico.

    Tamaño máximo: 1

• receptaculo: Alfanumérico.

• referencia_grupo: Alfanumérico.

  Tamaño máximo: 50

• representante_id: Entero.

• ubicacion: Alfanumérico.

  Tamaño máximo: 35

Ejemplos

{
    "clientes": [
        {
            "firmantes": [],
            "avisos": [],
            "avales": [],
            "certificados": [],
            "id": 1,
            "nombre": "TARIC S.A.U.",
            "codigo": "TARIC_CLNT",
            "nif": "A78587268",
            "prefijo_telefono": "34",
            "numero_telefono": "9999",
            "extension_telefono": null,
            "numero_fax": null,
            "direccion": "BOIX Y MORER",
            "localidad": "MADRID",
            "codigo_postal_espana": "003",
            "codigo_provincia": "28",
            "clave_declarante": null,
            "garantia": null,
            "aduana_habitual": "9999",
            "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": 0,
            "acogido_domiciliacion": 0,
            "recapitulativos_exportacion": 0,
            "autorizacion": null,
            "codigo_expedidor_autorizado": null,
            "usar_sello_expedidor": 0,
            "ubicacion_expedidor": null,
            "modo_pago": null,
            "e_mail": "test@taric.es",
            "garantia_cabildo": null,
            "garantia_transito": null,
            "e_mail2": "test2@taric.es",
            "eori": "ESA78587268",
            "plazo_cobro": 0,
            "iva_diferido": 0,
            "tipo_persona": "J",
            "numero_calle": "6",
            "centro_comex": "2801",
            "es_pasaporte": 0,
            "intermediario_id": null
        }
    ],
    "agentes": [],
    "g3v2s": [
        {
            "partidas": [
                {
                    "doc_transporte_tipo": null,
                    "doc_transporte_numero": null,
                    "doc_previo_tipo": null,
                    "doc_previo_numero": null,
                    "doc_previo_partida": null,
                    "info_adicional_codigo": null,
                    "info_adicional_descripcion": null,
                    "codigo_levante": null,
                    "estado": null
                }
            ],
            "envios": [],
            "id": 48,
            "version": 2,
            "completed": 1,
            "expediente": "TDUAG3L00046",
            "referencia_grupo": "MINIMO DOCU",
            "observaciones": "OBS",
            "estado_envio": null,
            "estado_previo_envio": null,
            "fecha_creacion": "2026-01-30T16:50:45",
            "fecha_alta_declaracion": null,
            "nombre_usuario_ultima_modificacion": null,
            "nombre_usuario_declarante": null,
            "mrn": null,
            "fecha_mrn": null,
            "codigo_levante": null,
            "csv": null,
            "aduana": "ES009998",
            "clave_declarante": null,
            "agente_id": null,
            "declarante_id": 1,
            "representante_id": null,
            "doc_transporte_tipo": "N740",
            "doc_transporte_numero": "MASTER04120079",
            "conocimiento": null,
            "ubicacion": "ES009998AAAAAA",
            "doc_previo_tipo": null,
            "doc_previo_numero": "25ESG4A000000027U4",
            "doc_previo_partida": null,
            "contenedores": [],
            "receptaculo": null,
            "fecha_presentacion": "2026-02-05T00:00:00",
            "is_agente": true,
            "ubicacion_nacional": "9998AAAAAA",
            "aduana_nacional": "9998",
            "incidencia": null,
            "registered": false,
            "display_estado": "-----------",
            "documento": null
        }
    ]
}

Importación de datos

Campos

• expediente: Alfanumérico. Obligatorio.

  Tamaño máximo: 22

• version: Lista de valores predefinidos. Obligatorio.

  Valores aceptados:

  2: G3v2
  

• aduana: Lista de valores predefinidos.

  Valores aceptados: Aduanas Españolas

• agente_id: Entero.

• clave_declarante: Lista de valores predefinidos.

  Valores aceptados:

  1: Autodespacho (igual a vacío)
  2: Representación directa a tenor del artículo 18. 1 del Código.
  3: Representación indirecta a tenor del artículo 18. 1 del Código.
  

• codigo_levante: Lista de valores predefinidos.

  Valores aceptados:

  VE: Circuito Verde. Levante Permitido
  LN: Levante no permitido para una o varias mercancías
  

• completed: Lista de valores predefinidos.

  Valor por defecto: 0

  Valores aceptados:

  0: No
  1: Si
  

• conocimiento: Alfanumérico.

  Tamaño máximo: 35

• contenedores: Lista.

  • numero: Alfanumérico.

    Tamaño máximo: 17

• csv: Alfanumérico.

  Tamaño máximo: 16

• declarante_id: Entero.

• doc_previo_numero: Alfanumérico.

  Tamaño máximo: 70

• doc_previo_partida: Alfanumérico.

  Tamaño máximo: 5

• doc_previo_tipo: Lista de valores predefinidos.

  Valores aceptados:

  N337
  

• doc_transporte_numero: Alfanumérico.

  Tamaño máximo: 70

• doc_transporte_tipo: Lista de valores predefinidos.

  Valores aceptados:

  5025: NÚMERO DE ENVÍO
  N703: HOJA DE RUTA EMITIDA POR UN TRANSITARIO
  N704: CONOCIMIENTO PRINCIPAL
  N705: CONOCIMIENTO DE EMBARQUE
  N714: CONOCIMIENTO EMITIDO POR UN TRANSITARIO
  N720: CARTA DE PORTE CIM
  N722: LISTA DE ACOMPAÑAMIENTO - SMGS
  N730: BOLETÍN DE EXPEDICIÓN POR CARRETERA
  N740: TÍTULO DE TRANSPORTE AÉREO
  N741: HOJA DE RUTA AÉREA PRINCIPAL
  N750: ENVÍOS POSTALES, INCLUIDOS LOS PAQUETES POSTALES
  N760: DOCUMENTO DE TRANSPORTE MULTIMODAL/COMBINADO
  

• estado_envio: Alfanumérico.

  Tamaño máximo: 4

• estado_previo_envio: Alfanumérico.

  Tamaño máximo: 4

• fecha_alta_declaracion: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• fecha_creacion: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• fecha_mrn: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• fecha_presentacion: Fecha y hora.

  Formato: %Y-%m-%dT%H:%M:%S

• mrn: 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

• observaciones: Alfanumérico.

  Tamaño máximo: 100

• partidas: Lista.

  • codigo_levante: Lista de valores predefinidos.

    Valores aceptados:

    VE: Circuito Verde. Levante Permitido
    LT: En período de latencia
    CA: Pendiente control aduanero
    N7: No existe H7 previamente declarado
    

  • doc_previo_numero: Alfanumérico.

    Tamaño máximo: 70

  • doc_previo_partida: Alfanumérico.

    Tamaño máximo: 5

  • doc_previo_tipo: Lista de valores predefinidos.

    Valores aceptados:

    N337
    

  • doc_transporte_numero: Alfanumérico.

    Tamaño máximo: 70

  • doc_transporte_tipo: Lista de valores predefinidos.

    Valores aceptados:

    5025: NÚMERO DE ENVÍO
    N703: HOJA DE RUTA EMITIDA POR UN TRANSITARIO
    N704: CONOCIMIENTO PRINCIPAL
    N705: CONOCIMIENTO DE EMBARQUE
    N714: CONOCIMIENTO EMITIDO POR UN TRANSITARIO
    N720: CARTA DE PORTE CIM
    N722: LISTA DE ACOMPAÑAMIENTO - SMGS
    N730: BOLETÍN DE EXPEDICIÓN POR CARRETERA
    N740: TÍTULO DE TRANSPORTE AÉREO
    N741: HOJA DE RUTA AÉREA PRINCIPAL
    N750: ENVÍOS POSTALES, INCLUIDOS LOS PAQUETES POSTALES
    N760: DOCUMENTO DE TRANSPORTE MULTIMODAL/COMBINADO
    

  • estado: Alfanumérico.

    Tamaño máximo: 1

• receptaculo: Alfanumérico.

• referencia_grupo: Alfanumérico.

  Tamaño máximo: 50

• representante_id: Entero.

• ubicacion: Alfanumérico.

  Tamaño máximo: 35

Ejemplos

{
    "clientes": [
        {
            "firmantes": [],
            "avisos": [],
            "avales": [],
            "certificados": [],
            "id": 1,
            "nombre": "TARIC S.A.U.",
            "codigo": "TARIC_CLNT",
            "nif": "A78587268",
            "prefijo_telefono": "34",
            "numero_telefono": "9999",
            "extension_telefono": null,
            "numero_fax": null,
            "direccion": "BOIX Y MORER",
            "localidad": "MADRID",
            "codigo_postal_espana": "003",
            "codigo_provincia": "28",
            "clave_declarante": null,
            "garantia": null,
            "aduana_habitual": "9999",
            "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": 0,
            "acogido_domiciliacion": 0,
            "recapitulativos_exportacion": 0,
            "autorizacion": null,
            "codigo_expedidor_autorizado": null,
            "usar_sello_expedidor": 0,
            "ubicacion_expedidor": null,
            "modo_pago": null,
            "e_mail": "test@taric.es",
            "garantia_cabildo": null,
            "garantia_transito": null,
            "e_mail2": "test2@taric.es",
            "eori": "ESA78587268",
            "plazo_cobro": 0,
            "iva_diferido": 0,
            "tipo_persona": "J",
            "numero_calle": "6",
            "centro_comex": "2801",
            "es_pasaporte": 0,
            "intermediario_id": null
        }
    ],
    "agentes": [],
    "g3v2s": [
        {
            "partidas": [
                {
                    "doc_transporte_tipo": null,
                    "doc_transporte_numero": null,
                    "doc_previo_tipo": null,
                    "doc_previo_numero": null,
                    "doc_previo_partida": null,
                    "info_adicional_codigo": null,
                    "info_adicional_descripcion": null,
                    "codigo_levante": null,
                    "estado": null
                }
            ],
            "envios": [],
            "id": 48,
            "version": 2,
            "completed": 1,
            "expediente": "TDUAG3L00046",
            "referencia_grupo": "MINIMO DOCU",
            "observaciones": "OBS",
            "estado_envio": null,
            "estado_previo_envio": null,
            "fecha_creacion": "2026-01-30T16:50:45",
            "fecha_alta_declaracion": null,
            "nombre_usuario_ultima_modificacion": null,
            "nombre_usuario_declarante": null,
            "mrn": null,
            "fecha_mrn": null,
            "codigo_levante": null,
            "csv": null,
            "aduana": "ES009998",
            "clave_declarante": null,
            "agente_id": null,
            "declarante_id": 1,
            "representante_id": null,
            "doc_transporte_tipo": "N740",
            "doc_transporte_numero": "MASTER04120079",
            "conocimiento": null,
            "ubicacion": "ES009998AAAAAA",
            "doc_previo_tipo": null,
            "doc_previo_numero": "25ESG4A000000027U4",
            "doc_previo_partida": null,
            "contenedores": [],
            "receptaculo": null,
            "fecha_presentacion": "2026-02-05T00:00:00"
        }
    ]
}