Biblioteca de Templates

🏢 Clientes

Cliente PJ (Indústria/Comércio)

ADRMAS03 + DEBMAS07

Template completo para cadastro de pessoa jurídica no mercado nacional.

JSON Payload

{
  "ADRMAS03": {
    "E1ADRMAS": {
      "OBJ_TYPE": "KNA1",
      "CONTEXT": "0001",
      "E1BPAD1VL": [{
        "NAME": "INDÚSTRIA MODELO LTDA",
        "STREET": "AVENIDA INDUSTRIAL",
        "HOUSE_NO": "1000",
        "POSTL_COD1": "04578-000",
        "CITY": "SAO PAULO",
        "REGION": "SP",
        "COUNTRY": "BR",
        "LANGU": "P",
        "LANGU_ISO": "PT"
      }],
      "E1BPADSMTP": [{
        "E_MAIL": "nfe@industriamodelo.com.br"
      }]
    }
  },
  "DEBMAS07": {
    "E1KNA1M": {
      "KTOKD": "Z001",
      "LAND1": "BR",
      "NAME1": "INDÚSTRIA MODELO LTDA",
      "STCD1": "12345678000190",
      "STCD3": "123456789",
      "STCD4": "98765432",
      "E1KNB1M": [{
        "BUKRS": "1000",
        "AKONT": "11210001",
        "ZTERM": "Z040",
        "ZWELS": "E"
      }],
      "E1KNVVM": [{
        "VKORG": "2000",
        "VTWEG": "20",
        "SPART": "30",
        "WAERS": "BRL",
        "ZTERM": "Z040",
        "VSBED": "01",
        "E1KNVPM": [
          { "PARVW": "AG", "KUNN2": "10000661", "PARZA": "000" },
          { "PARVW": "WE", "KUNN2": "10000661", "PARZA": "000" }
        ],
        "E1KNVIM": [
          { "ALAND": "BR", "TATYP": "IBRX", "TAXKD": "1" },
          { "ALAND": "BR", "TATYP": "IPI1", "TAXKD": "1" }
        ]
      }]
    }
  }
}

💡 AKONT fica dentro de E1KNB1M, não na raiz. Se colocar na raiz o IDoc falha.

⚠️ STCD1 = CNPJ, STCD3 = IE, STCD4 = IM

Cliente PF (Consumidor Final)

B2C / VAREJO

Template para pessoa física identificada por CPF.

JSON Payload

{
  "ADRMAS03": {
    "E1ADRMAS": {
      "E1BPAD1VL": [{
        "NAME": "SIDNEY CORREIA",
        "CITY": "SAO PAULO",
        "POSTL_COD1": "01005-000",
        "STREET": "RUA BENJAMIM CONSTANT",
        "HOUSE_NO": "10",
        "COUNTRY": "BR",
        "REGION": "SP"
      }]
    }
  },
  "DEBMAS07": {
    "E1KNA1M": {
      "KTOKD": "Z010",
      "NAME1": "SIDNEY CORREIA",
      "STCD2": "12345678900",
      "STKZN": "X",
      "LAND1": "BR",
      "E1KNB1M": [{
        "BUKRS": "1000",
        "AKONT": "11210002",
        "ZTERM": "Z001"
      }],
      "E1KNVVM": [{
        "VKORG": "2000",
        "VTWEG": "10",
        "SPART": "30",
        "WAERS": "BRL",
        "E1KNVIM": [
          { "ALAND": "BR", "TATYP": "IBRX", "TAXKD": "0" }
        ]
      }]
    }
  }
}

❌ Para PF, CPF vai no STCD2 e STKZN deve ser "X". CPF no STCD1 causa erro de dígito verificador.

Cliente Estrangeiro (Exportação)

FOREIGN TRADE

Template com configuração de Incoterms para comércio exterior.

JSON Payload

{
  "ADRMAS03": {
    "E1ADRMAS": {
      "E1BPAD1VL": [{
        "NAME": "TIMBERLAND US INC",
        "STREET": "BROADWAY",
        "HOUSE_NO": "500",
        "CITY": "NEW YORK",
        "REGION": "NY",
        "COUNTRY": "US",
        "LANGU_ISO": "EN"
      }]
    }
  },
  "DEBMAS07": {
    "E1KNA1M": {
      "KTOKD": "Z002",
      "LAND1": "US",
      "NAME1": "TIMBERLAND US INC",
      "E1KNB1M": [{
        "BUKRS": "1000",
        "AKONT": "11210003",
        "ZWELS": "T"
      }],
      "E1KNVVM": [{
        "VKORG": "2000",
        "VTWEG": "99",
        "SPART": "30",
        "WAERS": "USD",
        "INCO1": "FOB",
        "INCO2": "NEW YORK",
        "E1KNVIM": [
          { "ALAND": "BR", "TATYP": "IBRX", "TAXKD": "0" }
        ]
      }]
    }
  }
}

💡 INCO1 = Incoterm (FOB, CIF, etc.), INCO2 = Local de entrega

🚚 Fornecedores

Fornecedor Nacional

ADRMAS03 + CREMAS06

Template para cadastro de fornecedor pessoa jurídica nacional.

JSON Payload

{
  "ADRMAS03": {
    "E1ADRMAS": {
      "OBJ_TYPE": "LFA1",
      "CONTEXT": "0001",
      "E1BPAD1VL": [{
        "NAME": "FORNECEDOR MODELO LTDA",
        "STREET": "RUA DOS FORNECEDORES",
        "HOUSE_NO": "500",
        "POSTL_COD1": "01310-100",
        "CITY": "SAO PAULO",
        "REGION": "SP",
        "COUNTRY": "BR"
      }]
    }
  },
  "CREMAS06": {
    "E1LFA1M": {
      "KTOKK": "Z001",
      "LAND1": "BR",
      "NAME1": "FORNECEDOR MODELO LTDA",
      "STCD1": "98765432000199",
      "E1LFB1M": [{
        "BUKRS": "1000",
        "AKONT": "21100001",
        "ZTERM": "Z030",
        "ZWELS": "B"
      }],
      "E1LFM1M": [{
        "EKORG": "1000",
        "WAERS": "BRL",
        "ZTERM": "Z030",
        "INCO1": "CIF",
        "INCO2": "SAO PAULO"
      }]
    }
  }
}

💡 AKONT em E1LFB1M é a conta contábil de fornecedor (passivo)

⚠️ E1LFM1M contém dados da organização de compras (EKORG)

📦 Materiais

Material Produto Acabado

MATMAS05

Template de material tipo FERT com dados de centro e área de vendas.

JSON Payload

{
  "MATMAS05": {
    "E1MARAM": {
      "MATNR": "000000000012345678",
      "MTART": "FERT",
      "MATKL": "001",
      "MEINS": "UN",
      "BRGEW": "1.500",
      "NTGEW": "1.200",
      "GEWEI": "KG",
      "E1MAKTM": [{
        "SPRAS": "P",
        "SPRAS_ISO": "PT",
        "MAKTX": "PRODUTO ACABADO MODELO"
      }],
      "E1MARCM": [{
        "WERKS": "1000",
        "LADGR": "0001",
        "PRCTR": "1000",
        "E1MARDM": [{
          "LGORT": "0001"
        }]
      }],
      "E1MVKEM": [{
        "VKORG": "2000",
        "VTWEG": "20",
        "SPART": "30",
        "KONDM": "01",
        "KTGRM": "01"
      }]
    }
  }
}

💡 MATNR deve ter 18 caracteres com zeros à esquerda

⚠️ MEINS (unidade base) deve existir no SAP antes do envio