二维码配置工具

给你家平台的码配一张对照表

不同平台的二维码里装的键名不一样 —— 有的叫 on、pc，有的叫 an、ap。 系统得有一张对照表才知道该怎么读。扫一次码，把解析内容贴进来，字段自动填好，导出 JSON 导入后台即生效。

所有解析与生成都在你自己的浏览器里完成，文件不会上传到任何服务器，官网也不保存你贴的内容。

1把码的内容弄进来

先用手机扫一个你常买的平台的二维码，把解析出来的内容复制回来。 暂时没有码也行，直接往下填。

打开扫码工具 换个工具

扫码工具是第三方公益站，本官网不参与、也不保存你扫的内容 —— 粘贴框在你自己的浏览器里。

整段贴进来就行，格式不用管 —— 括号、key=value、网址参数、JSON 都能认。
还没选文件
支持的文件格式：
· 文本 / JSON 样例 —— .txt .json .csv .log，内容就是扫码工具解析出来的那一串；
· 二维码图片 —— .png .jpg .webp .gif .bmp，需要浏览器支持图片解码（Chrome / Edge 可以，Safari 与 Firefox 不行）。
表格文件（.xlsx .xls）请在 Excel 里选中单元格复制内容，再粘到上面的框里。

2平台信息

小写字母、数字、下划线或短横线，2–32 位，以字母或数字开头。导入时按它匹配平台。
选填。平台还没建时，导入那一步会拿它预填新建表单。

3对照表

系统真正会读的只有四个字段。二维码里多出来的键不用管，会被忽略。 自动识别是按常见键名和值的形状猜的，填好之后请逐行核对，别直接导出。

4导出

配置文件预览 


            

              
              
              
            

            
文件在你自己的浏览器里生成，不上传任何地方。

          


          
          

            
              
              使用帮助
              
            
            

              
    
                
  1. 粘贴二维码原始内容，或上传样例图片。
    2. 
                
  2. 核对字段映射关系，手动修正偏差 —— 认不准的一律先留空。
    3. 
                
  3. 预览生成的配置文件，确认没有待修正项。
    4. 
                
  4. 下载 JSON 配置，在系统后台「平台管理」中上传。
    5. 
              

              

                为什么要核对：自动识别靠键名和值的形状去猜，认错比认不出更麻烦 ——
                认不出会退回兜底流程，认错会翻出错的编号或型号。
              

            

          

        


      

    

  


  
  

    

      

        导入
        
怎么用上它

        
导进去的地方在「平台管理」页，三步。

      


      
    
        
  1. 
          
            1
            
          
          
    
            
    打开平台管理
    
            
    后台「平台管理」页，顶部有一个「导入扫码参数配置」按钮。
    
          
    
        
    2. 
        
  2. 
          
            2
            
          
          
    
            
    选文件，导入并覆盖
    
            
    选刚下载的 .json。代码能对上已有平台就直接覆盖那份配置；对不上会先问你要不要新建平台，不会自己悄悄建。
    
          
    
        
    3. 
        
  3. 
          
            3
            
          
          
    
            
    扫一个码试试
    
            
    拿该平台真实的二维码扫一下，看字段有没有被认出来。想改的话，在「编辑平台 → 扫码参数设置」里直接改 JSON。
    
          
    
        
    4. 
      


      

        

          导入是整份替换，不是合并 —— 老的对照关系不会留下。想只改一两个键，用「编辑平台 → 扫码参数设置」局部改更稳妥。
          配置跟着平台走，平台删了配置也跟着没。
        

      

    

  


  
  

    

      

        字段
        
这几个字段才真的会被读

        
二维码能带的键不多，系统真正用到的也就四个。多映射并不会多生效。

      


      

        

          
            
系统字段作用

          
          
            

              platform_part_no
              商品编号（平台编号）—— 当作条码去匹配或建档，是扫码识别的主身份
            

            

              model
              型号 —— 多个候选时参与判定
            

            

              quantity
              数量 —— 入库数量
            

            

              order_no
              订单编号 —— 关联订单号
            

          
        

      


      

        

          二维码里多出来的键不用管。 没写进对照表的原始键会被静默忽略 —— 不报错，也不影响识别。
          但对照表左边的系统字段名不能写错：写平台自己的短键（比如 mc、pdi）会被整份拒绝。
        

        

          系统的内置白名单里还有一批订单和资料类字段（收货人、快递公司、发票号之类），扫码用不上，
          所以这个生成器只放上面这四个。完整的字段表在源码的
          app/Helper/Parser/FieldRegistry.php 里。
        

        

          一套码制里至少要映射 platform_part_no 或 model 之一，
          否则这个平台的码翻不出有效身份，识别会退回兜底。
        

      


      

        

          两个容易踩的坑：

          · 判定键（match）写错 → 这个平台的码认不出来，扫描时走兜底流程；

          · 对照关系写错 → 能认出来，但翻出的编号或型号是错的，比认不出更麻烦。改之前建议先把当前配置复制一份留底。