Añadir un campo NIF/CIF en el checkout de WooCommerce y mostrarlo en pedidos y emails

Dificultad: Media

Si vendes a empresas o autónomos en España, necesitas el NIF o CIF del cliente para poder facturar. WooCommerce no lo incluye de serie, y es habitual resolverlo con un plugin pesado solo para añadir un campo. Este snippet lo añade a los datos de facturación del checkout, normaliza lo que escribe el cliente, comprueba que el formato sea el de un DNI, un NIE o un CIF, y lo guarda con el pedido para verlo en el administrador y en los emails.

Puedes utilizar este sencillo snippet en php desde el archivo functions.php.

Importante: no modifiques directamente el archivo functions.php del tema que tengas instalado. Genera un tema hijo con alguno de los plugins del repositorio de WordPress y actívalo. Cuando lo tengas, entra en el functions.php del tema hijo. Una alternativa es instalar algún plugin que permite incrustar código sin problema de pérdida en la actualización del tema.


/**
 * Campo NIF/CIF en el checkout de WooCommerce: validación, pedido y emails
 */

// 1. Añadir el campo en los datos de facturación, justo después de la empresa
add_filter( 'woocommerce_checkout_fields', 'lc_nif_campo' );
function lc_nif_campo( $fields ) {
    $fields['billing']['billing_nif'] = array(
        'type'        => 'text',
        'label'       => 'NIF/CIF',
        'placeholder' => 'Ej.: 12345678Z',
        'required'    => false, // Cámbialo a true si quieres que sea obligatorio
        'class'       => array( 'form-row-wide' ),
        'priority'    => 35,
    );
    return $fields;
}

// 2. Normalizar el valor: mayúsculas y sin espacios, guiones ni puntos
add_filter( 'woocommerce_process_checkout_field_billing_nif', 'lc_nif_normalizar' );
function lc_nif_normalizar( $valor ) {
    return strtoupper( str_replace( array( ' ', '-', '.' ), '', $valor ) );
}

// 3. Validar el formato (DNI, NIE o CIF). No comprueba la letra de control
add_action( 'woocommerce_after_checkout_validation', 'lc_nif_validar', 10, 2 );
function lc_nif_validar( $data, $errors ) {
    if ( empty( $data['billing_nif'] ) ) {
        return;
    }
    $patron = '/^([0-9]{8}[A-Z]|[XYZ][0-9]{7}[A-Z]|[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J])$/';
    if ( ! preg_match( $patron, $data['billing_nif'] ) ) {
        $errors->add(
            'billing_nif_error',
            '<strong>NIF/CIF</strong> no tiene un formato válido.',
            array( 'id' => 'billing_nif' )
        );
    }
}

// 4. Mostrar el NIF/CIF en el pedido del administrador
add_action( 'woocommerce_admin_order_data_after_billing_address', 'lc_nif_admin_pedido' );
function lc_nif_admin_pedido( $order ) {
    $nif = $order->get_meta( '_billing_nif' );
    if ( $nif ) {
        echo '<p><strong>NIF/CIF:</strong> ' . esc_html( $nif ) . '</p>';
    }
}

// 5. Mostrar el NIF/CIF en los emails de WooCommerce
add_filter( 'woocommerce_email_order_meta_fields', 'lc_nif_email', 10, 3 );
function lc_nif_email( $fields, $sent_to_admin, $order ) {
    $nif = $order->get_meta( '_billing_nif' );
    if ( $nif ) {
        $fields['billing_nif'] = array(
            'label' => 'NIF/CIF',
            'value' => $nif,
        );
    }
    return $fields;
}

Obligatorio u opcional: Por defecto el campo es opcional. Si necesitas el dato en todos los pedidos, cambia 'required' => false por true y WooCommerce mostrará su propio aviso de campo obligatorio.

Validación de formato, no de letra de control: El snippet comprueba que el valor tenga la forma de un DNI (8 cifras y una letra), un NIE (X, Y o Z, 7 cifras y una letra) o un CIF (letra, 7 cifras y un dígito o letra de control). Evita errores de teclado evidentes, pero no verifica que la letra de control sea la correcta. Si necesitas esa comprobación estricta, habría que ampliar la función de validación.

Se guarda con el pedido: WooCommerce guarda los campos de facturación personalizados como datos del pedido (aquí _billing_nif), de modo que el dato queda asociado a cada compra y se puede leer con $order->get_meta(), también con el almacenamiento de pedidos de alto rendimiento (HPOS).

Compatibilidad: Funciona con el checkout clásico de WooCommerce. Si usas el bloque «Finalizar compra», estos hooks no se ejecutan y el campo no aparecerá. Si montas el checkout con el widget de Elementor Pro, comprueba que el campo se muestra antes de dar el cambio por bueno.

Si quieres seguir ajustando el checkout y el carrito, mira también cómo establecer un límite mínimo de pedido en WooCommerce.

¿Necesitas esto en tu web?

Desarrollo funciones a medida e integraciones para WordPress y tiendas WooCommerce, y reviso con una auditoría las tiendas que van lentas o dan errores. Cuéntame tu caso.