Biblioteca de Templates
Copie modelos JSON prontos e validados para acelerar sua integração.
Cliente PJ (Indústria/Comércio)
ADRMAS03 + DEBMAS06{
"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"
}]
}
},
"DEBMAS06": {
"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" }
]
}
]
}
}
}
💡 Estrutura Hierárquica: Note que
AKONT fica dentro de E1KNB1M e não na raiz. Se colocar na raiz (`E1KNA1M`), o IDoc falha ou ignora o dado contábil.
Cliente PF (Consumidor Final)
Identificação via CPF{
"ADRMAS03": {
"E1ADRMAS": {
"E1BPAD1VL": [{
"NAME": "SIDNEY CORREIA",
"CITY": "SAO PAULO",
"POSTL_COD1": "01005-000",
"STREET": "RUA BENJAMIM CONSTANT",
"HOUSE_NO": "10",
"COUNTRY": "BR",
"REGION": "SP"
}]
}
},
"DEBMAS06": {
"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" }
]
}
]
}
}
}
⚠️ Erro Comum: Para Pessoa Física, o CPF vai no
STCD2 e o campo STKZN deve ser "X". Se mandar CPF no STCD1 (campo de CNPJ), o SAP rejeita por erro de dígito verificador.
Cliente Estrangeiro (Exportação)
Configuração Incoterms{
"ADRMAS03": {
"E1ADRMAS": {
"E1BPAD1VL": [{
"NAME": "TIMBERLAND US INC",
"STREET": "BROADWAY",
"HOUSE_NO": "500",
"CITY": "NEW YORK",
"REGION": "NY",
"COUNTRY": "US",
"LANGU_ISO": "EN"
}]
}
},
"DEBMAS06": {
"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" }
]
}
]
}
}
}
Fornecedor Nacional PJ (Padrão)
CREMAS06 + Domicílio Fiscal{
"ADRMAS03": {
"E1ADRMAS": {
"OBJ_TYPE": "LFA1",
"CONTEXT": "0001",
"E1BPAD1VL": [{
"NAME": "INDÚSTRIA METALÚRGICA DO SUL LTDA",
"NAME_2": "FILIAL SC",
"STREET": "RODOVIA BR 101",
"HOUSE_NO": "KM 40",
"POSTL_COD1": "89200-000",
"CITY": "JOINVILLE",
"REGION": "SC",
"COUNTRY": "BR",
"LANGU": "P",
"TAXJURCODE": "SC 4209102"
}],
"E1BPADSMTP": [{ "E_MAIL": "vendas @metalurgicasul.com.br" }]
}
},
"CREMAS06": {
"E1LFA1M": {
"KTOKD": "FORN",
"NAME1": "INDÚSTRIA METALÚRGICA DO SUL LTDA",
"LAND1": "BR",
"STCD1": "12345678000199",
"STCD3": "251234567",
"STCD4": "45678901",
"E1LFB1M": [{
"BUKRS": "1000",
"AKONT": "21100001",
"ZTERM": "0030",
"ZWELS": "F",
"FDGRV": "A1"
}],
"E1LFM1M": [{
"EKORG": "1000",
"WAERS": "BRL",
"WEBRE": "X",
"LEBRE": "X",
"KALSK": "BR01",
"E1WYT3M": [
{ "PARVW": "LF", "LIFN2": "", "PARZA": "000" },
{ "PARVW": "RS", "LIFN2": "", "PARZA": "000" }
]
}]
}
}
}
Fornecedor Pessoa Física (Autônomo)
Dados Bancários para Transferência{
"ADRMAS03": {
"E1ADRMAS": {
"OBJ_TYPE": "LFA1",
"E1BPAD1VL": [{
"NAME": "MARIA DA SILVA CONSULTORIA",
"STREET": "RUA DAS FLORES",
"HOUSE_NO": "123",
"CITY": "SAO PAULO",
"POSTL_COD1": "01310-200",
"REGION": "SP",
"COUNTRY": "BR"
}]
}
},
"CREMAS06": {
"E1LFA1M": {
"KTOKD": "ZAUT",
"NAME1": "MARIA DA SILVA CONSULTORIA",
"LAND1": "BR",
"STCD2": "98765432100",
"STKZN": "X",
"E1LFB1M": [{
"BUKRS": "1000",
"AKONT": "21100002",
"ZTERM": "Z000",
"ZWELS": "T",
"HBKID": "ITAU"
}],
"E1LFBKM": [{
"BANKS": "BR",
"BANKL": "341",
"BANKN": "12345-6",
"BKONT": "12",
"KOINH": "MARIA DA SILVA"
}],
"E1LFM1M": [{
"EKORG": "1000",
"WAERS": "BRL",
"LEBRE": "X",
"WEBRE": ""
}]
}
}
}
💰 Dados Bancários: O segmento
E1LFBKM é crítico para pagamentos via transferência (TED/DOC/PIX). O campo KOINH (Titular) deve ser igual ao nome do cadastro para evitar rejeição bancária.
Material de Consumo / Peça (Indústria)
MATMAS05 + Textos Longos{
"MATMAS05": {
"E1MARAM": [{
"MATNR": "000000000000111211",
"MBRSH": "M",
"MTART": "ERSA",
"MEINS": "UN",
"MATKL": "YBR05",
"BRGEW": "0.150",
"GEWEI": "KG",
"SPART": "05",
"TRAGR": "0001",
"E1MAKTM": [{
"MAKTX": "PORCA SEXTAVADA INOX 10MM",
"SPRAS": "P",
"SPRAS_ISO": "PT"
}],
"E1MARCM": [{
"WERKS": "1000",
"LADGR": "0004",
"MTVFP": "DR",
"BESKZ": "F",
"E1MARDM": [{
"LGORT": "0001"
}]
}],
"E1MTXHM": [
{
"TDOBJECT": "MATERIAL",
"TDNAME": "000000000000111211",
"TDID": "GRUN",
"TDSPRAS": "P",
"SPRAS_ISO": "PT",
"E1MTXLM": [
{ "TDLINE": "PORCA; TIPO: SEXTAVADA; MATERIAL: ACO INOX;" },
{ "TDLINE": "ROSCA: ASME B1.1; NORMA: DIN 934" }
]
},
{
"TDOBJECT": "MATERIAL",
"TDNAME": "000000000000111211",
"TDID": "BEST",
"TDSPRAS": "P",
"SPRAS_ISO": "PT",
"E1MTXLM": [
{ "TDLINE": "ATENCAO: EXIGIR CERTIFICADO DE QUALIDADE" }
]
}
]
}]
}
}
📝 Textos Longos: O segmento
E1MTXHM fica no mesmo nível que o E1MAKTM. Use o ID GRUN para textos técnicos gerais e BEST para textos que devem sair impressos no Pedido de Compra.
Material de Revenda (Simples)
Venda e Código de Barras (EAN){
"MATMAS05": {
"E1MARAM": [{
"MATNR": "SKU-500",
"MTART": "HAWA",
"MBRSH": "1",
"MEINS": "PC",
"EAN11": "7891000200030",
"E1MAKTM": [{
"MAKTX": "SMARTPHONE GALAXY 128GB",
"SPRAS": "P"
}],
"E1MVEGM": [{
"VKORG": "2000",
"VTWEG": "10"
}]
}]
}
}
A integração quebrou por dados ruins?
Validar se o CNPJ é válido, se o NCM existe ou se a unidade está correta manualmente é arriscado.
O 4MDG automatiza 100% dessas regras antes do dado chegar ao SAP.